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1.1 AN OVERVIEW OF CHANGES IN kfcQ 



R 8 0 is co (ii posed of a group of incremental enhancements to Pick 
Associates R77 release. The primary emphasis is on enhancement 
(software speed and reliability through the clarification* refinement* 
standardization of the system cocie. This has occurred in essentially 
of the processors which compose the system. Most of the modifications 
transparent to the user* ana witi not ce discussed below. 


6 
of 
and 
a I I 
are 


1.2 CHANGES IN THE TERMINAL INTERFACE. 


1.2.1 The terminal handler activates on each character. 


The R77 release automatically activated the process receiving data from a 
terminal after 11 bytes or the occurrence of a carriage-return* whichever 
occurred first. New the process will activate on each character input 
from the terminal. It is thus possible to obtain one character and 
activate ^without a carriage-return* which allows certain features to be 
added. If you are sending a long report with pagination to the terminal* 
it may be terminated by executing a UGNTRUL-X* rather than with a BREAK 
and END sequence. The feature is usea similarly in the SP-EDITor with 
respect to. the T response to the SPLCL prompt* ana in the file save 
processor at mount-new-reeI time. 


1.2.2 Avoidance of BREAK ana END. 


.There has in general been an attempt to remove the need for BREAK and END 

The three most common and unnecessary uses have 
tin g s to trie terminal* using the form 'EDIT 
the SB-cDI Tor. All of these now allow an 
the stated task wit ft out tne use of 
as they were* ana are available a.s 


from-standard system use. 
been when displaying lone |i 
FILENAME * * anu- unaer sPLUl -T in 
escape before the enc of execution 
BREAK ana ENu. The 6 
needed. 


■ EAR and .thb 


c f 

r e 


1.2.3 Changes to the handling of the ESCAPE character. 


The ESCAPE cnaracter Ia'Id'S now passes into the system as a start buffer 
mark ( X ' - 3 ' ) for use with the prestore facility in the EDITOR. The result 
of this is that t he t SLAP E is no longer echoed as an ESCAPE. It' is echoed 
to the terminal as a X'bu* (L). This means that command sequences issued 
from the keyboard to the terminal wnich are implemented as an escape 
sequence ' will not .err. because c:e ESCAPE will not be echoed to. the 
terminal. The easiest wayar..c.unG. this is to put the terminal into local 
•moye * execute the escape • sequence * tah e the terminal oack out of local 
rode» execute a CON Foot-, t <. r '•n measure * and press on. Local a.oue is 
usually entered ana exited oy depressing a 'local* key* which will toggle 
a flag' in tne terminal. Shou 5 L there be no *a> to get i.n to .local mode 
with a given terminal* then a series of-cne-line BASIC programs can be 
written to send tne escape sequence to the terminal. In general * there 
rtiay be command sequences wnicn have meaning to a particular terminal which 
also have meaning to the system input processor. The special input 
control characters are Cuh FP uL-> * CLMTk UL-k-* ar.d CLNTRuL—w. They must se 
implemented with BASIC programs if they are necessary for terminal 
control. For instance* the BASIC program 'PRINT CHAR(18J' wiIi s end a 
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CONTRQL-R to the terminal 


Several of the verbs which do not reference filesor items have been 
modified so that they do not need the left parenthesis oefore any options 
„ which might be desired. See the relevant section in the documentation on 

• l - % the spoo ler. 

1 

1.3 CHANGES Td THE FILE HANDLER. 

The file-open routine nas been extensively changed (and moved* if you use 
assembly programs). The effect is transparent* but allows better system 
security arid more extensive use of Q pointers. The following table 
defines the level referenced by each field. 


FILENAME 
001 0 

002 ACCTNAME 
003 FILENAME 
004 


The name of the file to be used in file open cal Is 
Specifies this as a Q-pointer. 

The account name 

The name of the file referenced. 

Optional* as are all subsequent. 


basic L-pointer form. 


1.3.1 The reflexive form of tne L-pointer. 


If attributes two ana three are null* tne L-pointer is a pointer to the 
file in which it is stored. This case has two applications. If* on an 
kdO system you type ED Hu MD* you will rind that the only contents of the 
i .'••• D item is a 0 in attribute!. T h i s is i n g e n e r a I sufficient* a n u any 
other definition is less efficient. Specifically* tne MD entry should not 
be a u-po inter. Tne same follows for H /PICT or trh e account name entry 

The second use is in the case of a dictionary-only file. If it is desired 
to reference the f i ie w ith out typing *u I CT 1 each time* an entry with the 
same name, is tne L-pointer to the dictionary in the master dictionary is 
inserted in the tiie. dictionary .r.ust only contents is a Q. It is legal* 
but lass efficient* to have an k 77-S'ty i e L-pointer in the dictionary which 
* $ identical to the J -pointer in the master dictionary- 


In tne master dictionary 


File reference to ML. 
weference b ac n to '*h 


here you are now 


I n t n i 


e dictionary of the file FILEuAhE 

ILcNANt Tne name referenced, d y the name FILENAME 

in the master dictionary. 

Reference uac« tc tne dictionary itself. 


Uses of Las tne only attribute. 

Note that the name of the L-pointer is discarded as soon as the first D- 
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pointer is encountered. In.at is? a reference to Q'FILENAME which points to 
the file FILENAME will find the 0-pointer F1 LENA ME in the dictionary of 
FILENAME. It will not find a pointer oy the name of OFILENAME. A partial 
exception to this is in ENGLISH? which will attempt to obtain the 
conversion? length and justification from the Q-pointer. If the G-pointer 
does not contain them? then the ENGLISH compiler will search the D-pointer 
If o r t hem. If the D-pointer does not contain them? then the conversion 
will default to null? the justification to 'L'? ana the field length to 9 
bytes. It is therefore possible to specify various oifferent formats for 
the item-id field for purposes of sorting and listing. 


1.3.2 Account specification. 

The second attribute in any u-pointer references an account name. If 
attribute 2 is null? then the Q-pointer references a file in the account 
onto which you are logged. If attribute 2 is not null? the file open 
processor will search the system dictionary for a definition of the 
account name. If the processor does not find a U-pointer in the system 
dictionary? the system will respond.with trie following error message: 

12011 'Contents of attribute 2 of QF ILENAME' IS NOT A FILE NAME. 


It is possible to reference files in the account onto which you are logged 
by putting the name of the D-pointer to the account in attribute 2 of the 
G-pointer definition* The effect is to cause the system unnecessary work. 


Reference to the master dictionary of another account is done with the 
carp .of the u—pointer to the account in attribute 2 ana a null attibute 3. 



3.3 


File specification. 


Attribute 3 contains the name of the file referenced by the G-pointer. If 
attribute 3 is nut I? then the default is to the master dictionary 
specified' p.y attribute 2. The R77 version with MO in attribute 3 will not 
work, since is now a u-pc. inter . The following error message will be 
issued: 


12013 vyj* IS MiT A FILE .NAT. t . 

This occurs because MD is now a u-pointer. Note that Dackward conversions 
from i\dO tu k 77 will require that MD be redefined as a D-pointer. 


In general ? the 'file n<-.; - referenced in attribute 3 of the Q-pointer 
definition must be a D-pointer in the master dictionary of the account 
referenced in.attribute 2. 


1.3. A Extensions to the file n a m e reference. 


R77 introduced the facility of multiple data files referenced from a 

single dictionary. These were? and are pointed to by u- pointers in the 
dictionary of the file whose names are the names of the various data 

files. The t^cbn.i que used to reference a specific data file is by using 
the string 


IL! 


DAT A F i L t N AMc. 


Under R80 the contents of 


attribute 3 of the G-pointer definition may 
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contain FILENAME*DATAFILtNAME• In this case the O-pointer will reference 
the data in u A T AFILE NAME only* and will ignore the other datafiles 
referenced in the dictionary of FILENAME. The result is a considerable 
simplification of the BASIC programs .and PROCS which reference the various 
data sets in a mu 11ip I e-data-fi I e structure. 


herefore the 
DATAFILENAKE in 


following 0-pointer will reference the data file 
the dictionary of FILENAME in the account ACCOUNTNAME. 


— —— — — — — — — —— — — — — — — — — — — — — — — — —• —— — —————— —— , 

QFILE NAME { 

001 3 { 

002 ACCOUNTNAME { 

003 FILENAME »DATAFILENAME ! 


Referencing a uata file with a Q-pointer. 


Note that in the multiple data file case there may or may not be a data 
file with the same name as trie dictionary of the file. It may be 
convenient to create the file as a dictionary-only file and insert a Q- 
pointer in the dictionary with the same name as the file. The dictionary 
may then ue referenced without typing 'DICT*. This may be useful if there 
is to be extensive development of many data definition items. In general* 
there does not need to Le a oata file with the same name as the 
dictionary. 


1.3.5 Modifications to the file structure. 

% 

iT. 3.5.1 BASIC pro q ra^i files, 

T * o • c ha n a a s in f if e rotoccl s nave occurred* The first has to do w i t h 
BASIC pro a r a n* Hies* c*n u is treat e a in the section on BASIC# Simply* the 
.program fi ; e must ' have a- [actionary level ana one or more' oata level 
files* The source code must- d e in tne data level file- or J \ I es • If there 
are multiple oata files* an a a pro gran; of the same name in more than one 
’of t hem % stfan j e things nia , liappen • 1 he diet ionary level of the file will 

co n ta in pointers to contiguous strings *hich contain run modules emitted 
by the BASIC compiler. The master a let ionary entry for the BASIC program, 
file must contain a 1 u C 1 in attribute i. 


I • 3 * 6 * 2 Tne Pu INT Ek-F I L £ • 

Secondly* trie common Pul NTEk-F i Lt has been done away with, Bach account 
or yrouo' o f accounts' fray .be allocated a PUINTER-FILE by the system 
manager , The account name ct t he account generating a list is no longer 
stored es part of the list nam.e* ' as such it is possioie to' use the 

default list name 11 (null!* but it is not advisable to do so# 



Every pointer-file must contain a •DC 1 in attribute 1 of its definition* 

as before# It must be-, t* o- level* cut it- is convenient to- make the pointer 
to.the data level in the dictionary of the pointer-file a Q-pointer# The 
n a* rr e • P a I h f f k -rut is res e r v e a a n a k n o w n to t h e i- i s t h a n < iter* It is 
therefore possioie* anc may be convenient? to call the actual pointer-file 
or files by names - different than f DIMEK-FILE* and construct POINTER-FILE 
as a Q-pointer to whatever pointer-file is desired at the moment# In this 
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way any one pointer-fiie may be referenced 


1.3.6 Modifications to CREATE-FILE et alia 


The CREATE-FILE* DELETE-FILE, AND CLEAR-FILE verbs used to require a left 
^parenthesis* (. prior to the file name * or the key words DICT or DATA. 
The change is minor* and the old form still works* but it is consistent 
with Pick £ Associates' commitment to less typing. Note that Q-pointers 
may be used to reference files which are to be cleared* but that the D- 
pointer name is required if the file is to be deleted. The CREATE-FILE 
verb constructs a 0-pointer. If a data file is being added to an existing 
dictionary* the pointer to the dictionary will be a D-pointer. 
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1.4 CHANGES IN THE EDITOR. 


(m 


The primary 
omTiands. a 
'replace and 
instruct!ons 


improvements in the EDITOR are the addition of prestored 
c o n s i d e rable improvement, in the speed of the string locate, 
update commanas. and extension of the merge and file 


The increase in speed in the locate, replace, and delete commands is due 
to the use of more powerful instructions which are part of the RtiO 
firmware and are otherwise transparent. The same instructions have 
proliferated across other processors in the system, but will not'generally 
be noted. There are simply various places where the system will run 
locally faster than it uid under R77. Put this is one of the few that is 
at all visible to the user. 

< 

This discussion will begin with extensions to the EDITOR introduced during 
R77* because such documentation as they received were a few crabbed lines 
inserted in an already cramped text* 


1.4*1 Printing unprintable characters. 



Characters which are unprintable include the control characters* between 
X* 00 1 and X f lF f * inclusive. under KbO trie tuITcr marks control characters 
by inserting a period* 1 . 1 » where the control character stands in the text 
line. It a o e s not inaica te M n at the cnaracter is* however. It may then 
be r emov e c by replacing a unique string which includes the control 
character with the string ot your choice. The control character should oe 
ma r k e u wi tn an a in the first string in the replace. 


1.4.2 C h aiges to t n e Re p lace c omnia n c . 

Between R 7 7 ~ i C and k 77-1U the replace command was extended to allow * 

several e x c c a 1 1 o n s of the replace c o m ma no on a sin g i e line* and .an o p lion * 

w a s m a d a a v a i I a b le to all o « re p idcer^nt of ail copies of a string within a * 

line * i 1 1 trie specified r eo l ace.ment str mg. 


1.4.. 2.1 Multiple r e p i a c erae n t s w i t h i n a I i ne . 


The intent of the capacity to execute multiple replacements within a * line . * 
is to minimize typing ana buffer switching fine F command). If there are * 
several elements of a line which you wish to change* you may change them * 

one at a time* using the R command for each* without using the F command * 

in between. un each use of the R'command in this case* the command * 

operates on the result of the last command• only the first use of tne R .* 

command operates' on the. original line. T his.means that if the X command * 

is used* you move oacn to the original line* rather chan the line as it * 

was before the last use of the k command* because the last copy i *s not * 

saved. This means that it may be more- efficient to back out of an errant 
R command which is the last of several modifications to a particular line * 

by executing an K c o m ma no w h i c h • reverses trie last K command#; In general* $ 

you can modify a line indefinitely* * 


The column 
option may 


I i ns i ( parameters anu the rep lacement 
be used, with multiple R commands. 


of ail cases of a string 4 

4 
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If the replacement was a full—line replacement of the form R* carriage- 
return» followed by the prompt* followed by the text and a terminal 
carriage-return* the line may not be modified oy a string replace until 
the buffers have been exchanged using' the F command. The premise is that 
■ ' the X command can be used* followed oy another replace. If this is not 
t i sf ac t o r y * then the sequence* 'Ofc<i text<' will have the same result* 
“^and will allow replacements within the inserted iine. 


* 

* 

* 

* 


1.4. 2. 2 Replacement after mu ItipIe-1 ihe replacement. 

It has been possible to replace a given string in several lines by using * 
the form Rn for a long time. It is now possible to replace text in the * 
J.a§£ line in the Rn group using another k command without first flipping * 
the buffers (the F command) in the same way it can be modified after a * 
single line replacement command. It is not possible to access lines prior * 
to the last without using either the F command* which exchanges the * 
buffers* or the X command* which cancels the Rn replace command. 


1.4.2.3 Replacement after input. 



When inpu ting a oody of text* a typographical error might occur or one 
might change one's mind as to the text oeing entered. One can either use 
the X command to cancel all of the input string* or the F commano to flip 
the buffers to make the text available for correction. Either action is 
time-consuming and destructive of the natural flow of the text^ It is now 
possible to execute two carriage-returns* one to terminate the current 
line* ana one to return to command level* and then commence executing R 
commands to mocify tne last line of text inserted. Lines preceding the 
last line inserted can not be modified in this manner for the same reasons 
that.the lines before ttie last after a mu i t i p I e-I i n e replacement can not 
be modified. 


* 

* 

« 

$ 

$ 

£ 

V 

* 

£ 

$ 

& 


After the- line is mo a i tied to the point that it is satisfactory* one may * 
reenter t he input process oy executing the usual I* car r iage-re turn. * 


This may Pc acne after a single-line insertion generated try the form 

*£ texts,'** 


This may not te done at the end of the first body of text in an item Deing 
d e fin e a oy this execution of the EL IT verb* because when the it e m is new* 
t h e £ J i T J * a u t o m a t i c a H y exchanges tne buffers on return to control level 
after tne execution of an input command# It does not automatically 
exchange the buffers after text has been merged in to the new item from 
a n o t n a r i t c ; * a I f o * i n c m o 0 i r i c a t j o n of the .last I i n e o f i h e t e x t which h a s 
teen, me r .j e a i r . from - ana the r item* The automatic buffer exchange can be 
soever tea oy executing‘a f command, as soon as the new item is entered# 
M o t e t h a t v o u c ..in file the it e m . - n a the f i I e w I! I c c n tain an i te m w.n o s e 
only data is its item-id# [here are uses for key-only items# Once the 
buffers nave been•exchangee* the item will behave in the usual manner. 


1*4.2.4 Multiple replacements and the Herge command# 



It i s- now po ssi ole to merge one or more lines of text .into the current 
location in the text* and then modify the only or last, line merged in 
using the multiple replace fac i lily. Lines prior to the last can not be 
so modified for the reasons noted above. It is possible to do a lot of 
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text manipulation very quickly usiny the merge* delete and replace 
commands. 


1.4.3 A note on column specification. 

-^^Under R60* the first column is referenced oy i* and as usual by using a 
colon* * 2 * * as the delimiter between fielos. Columns are referenced 

according to the numbers returned by the C command. If a single-column 
reference is executed using the form 

R/X/Y/20 

Then the first 'X' in line after column 19 will be replaced with a 'Y*. 
The search will continue to the end of the line. 

If a two-column reference is executed using the form 

R/X/Y/20-22 


Then an 'X * in column 20* 21 or 22 will be rep laced with a ' Y' . If the 
form 


R/CAT/DOG/20-22 



is used* then the whole source string ’CAT' must be in the field starting 
at column 20 ana ending at column 22. This is equivalent to looking for 
the string 'CAT' which starts in column 2u. In other words* if the field 
being located by the locate* replace or delete commands is longer than one 
character ana if it is being searctteo for in mere than one column* then 
the ending column value must oe the beginning column plus the length of 
the string plus the number of columns in which the string may start minus 
1. The example which follows will hopefully clarify this proceedure. 
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If the line being considered 
is the following: 


084 the difference between the beginning and ending 


and we wish to replace the 
second ’the' with 'any'* then 


I 2 3 4 5 

I 234 5 67 89012 3 456789 0123 45 6 78 90123 4567 8901234 867 89012345 

allows us to observe that the 
second 'the* commences at 
column 24. we may then use 
the form 


R/the/any/24< 


which will yield 


084 the difference between any beginning and ending 


In order to use the column range 
specification* then we must use 
the form 


R/the/any/24-26< 


084 the difference between any beginning and ending 


R/t he/a n y/2 4-2 5 < 


If the for m 

is used* then the process will 
return to the prompt character 
without doing anything. The 
same will occur with 


R/tne/any/22 — 25< 


R /t h e / a n y / 2 5-2 7 < 


In general* success will occur- 
if the beginning column is prior 
to or on the first character to be 
identified in the line* and the 
ending column is greater than or on 
the address of the last character 
to o e ioentifleu in the line. 


Use of column specification with the replace. 

The protocols a cove are identical for trie string locate anc the form of 
the delete which deletes lines which contain a given string. 
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1.4.4 The Rep i ace-Un iv e rsaI command. * 

This is the form of the replace command* referenced above* which allows 
the replacement of all cases of the first string in the replace command 
ith che second string in the line or lines specified. This option is 
indicated by simply using the form RU for the command where R would be 
used in the normal case. The option allows multiple-line replacements 
using the form RUn for the form Rn* and it allows column specification* as 
above. An example of the replace-universal command demonstrating an 
alternative approach to the example above is below. 



0 84 The difference 

between 

the 

beginning 

and 

ending 

RU/tne/any 



V 



084 3ny difference 

between 

any 

beginning 

and 

ending 

r/any/the 






064 the difference 

between 

any 

beginning 

and 

ending 


Using trie Replace-Universal commana. 


This approach ri;ay be faster in real time* 
ana avoids typiny'the trailing delimiter 
calculating or estimating the location of 


since it 
in the 
the target 


requires less thought* 
replace statement and 
string in the line. 
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4.5 EXTENSIONS TO THE MERGE COMMANDS. 


4.5. 1 


The historical MErge command. 


The EDITor now allows items to be merged in from other files. 


Historically) the merge command. ME* allows text to be merged from 
anywhere in the current item if the item-id field is null* or from any 
item in the file being edited* including the file copy of the current 
item* oy the inclusion of the desired item-id in the merge command. The 
Editor has been extended so that text may be merged in from other files. 
Note that the syntax of the merge command has been as follows: 

MEnumber-of-lines/ITE M-ID/starting-line-number 

Thus: 

ME10/D0G/5 


will merge in ten lines of the item DOG in the file which contains the 
item currently being edited lthe FILENAME referencea in the EDIT command)* 
starting at line 5. In other words* line 5 through line 14 will be 
inserted a-fter the line currently displayed on the screen. 


4.5.2 Merging in items from other files. 

The extended syntax requires the use of the delimiters ( and ) in place of 
the / ' delimiter used above. They thus become reserved when using the 
merge command in the sense that the colon, is reserved when using the 

locate* replace, and delete commands. in this case there is the further 

peculiarity that ( and ) are' not the same character* whereas any character 
may nor ma I I y Le use a as a delimiter* so lor, g as all the delimiters ina 
particular string are identical. 

The new feature allows the following f or ms: 

fl}££<rk r "*'*’' 1 

MEnumber-of-i ib e s!DICI RILE NAME Rrfcr; IT E M N A M £)s t a r ting-line-number 
ME num oer - o f- I inesl FILENAr.E isE wITEMNAME ) star ting-l ine-number 
MEnumber-of-i i n e s ( U I C T F I i_t N A ME ) s t a r t i n g- i ine-number 
HEnumber-of-lines(FlLENAME)starting-line-number 

The use of Did is conventional. it means the same thing here as is does 
at TCl ii the reference to riles, anu in the DEFY processor. If there is 
no i tern-i u s p e c l f ied* trier, the processor defaui ts the item-id of tne 

item being edited at the moment. This is useful if one wishes to get a 
copy of an item into a test file ana euit it quickly* or if one wishes to 
assure that the item will not be filed Inadvertently over the old copy. 

ton Lined «rtn the prestore command structure ana the. increase' in speed of 

the .replace'command* some very powerful things can be done very quickly 

and easily. 

There are certain other defaults which apply to the merge command* and 
which are carried over into this extended form which will be noted below 
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as a reminder 



MEnumber-of 
MEnumber-of 
Enumber-of 
MEnumber-of 


I i ne s ( 0 I C T FILENAME NE toil TEMNAME 
I ines(FILENAME NEwITEMNAME 
I inesf DICT FILENAME 
I in e s(FI LENA ME 


These forms do the same thing as above* except that the starting line 
number defaults to line 1 in the merge source item. 


MEIDICT FILENAME NEWITEMNAME]starting-Iine-number 
ME(FI LENA ME NEwITEMNAME)s tar ting-Iine-number 
MEfDICT FlLENAME)starting-line-number 
ME(FILENAME)starting-line-number 


This does the same thing as above* except that starting-Iine-number is the 
only line which is mergeu into the destination item. As such* the line 
may then be moot tied using tne replace command* as noted above. 

ME(JILT FILENAME . NE riITEMNAME 


MEfFILENAME N £ WIT E M NA ML 



MEIDICT FILENAME 
ME(FILENAME 


This simply returns the tirst line of the merge source item. Note that 
the trail i r, j right parenthesis is optional if the starting line number 
■defaults’ to the first line of the' source.. 


Obviously* these defaults all apply to the normal merge statement* leading 
to the minimal form 'ME/** which simply inserts the first line of the item 
currently being edited into the current location in the item* which is 
useful if you wish to put a given line in several different places in an 
item. 


I.A.fc EXTENSIONS TO THE FILE COMMANDS. 

Along with the extension to the m e r ne command come a similar extension to 
the FI ana FA commands. roe may no« file’ the item currently being ecitec 
to either a different i tern in the current file* or to the same item name 
or to a different lien name in a different file. The syntax for tne r i 
and FS cd mman as are identical. ire uirference is that tne FS returns, you 
to the tap of the item currently being edited. You can not FD any item 
other than the one which you arc currently editing* by the way. Massive 
use of the FD can be accomplished with the DELETE verb (PR.DC) or by the 
use of a pres tore command. Tne delete verb: will oe faster. 


\ 4.6. 1 ri-liny items in ether files-. . 

The R 7 7 and earlier releases allowed the forms FI< and FS<. The extension 
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has the folowing form: 

FKDICT NEwFILENAME NEWlTEHNAME 


FKDICT NEWFILENAME 



I ( N E W F I L E N A M E 


NEWITEMNAME 


FI(NEWFILENAME 


FI NEWITEMNAME 

In the list of FI commands above* the first will file the item which you 
are editing into item NEwITEMNAME in the dictionary of NEWFILENAME; the 
second* into the same item name in the dictionary of NEWFILE,NAME* the 
third* into item NEwITtM.NAME in the data portion of NEWFILENAME# the 
forth* into the same item name in the data portion of NEWFILENMAME# and 
the fifth* into item NEW ITEMNAME in the file referenced in the EDIT 
command. In each case* an existing item will not be overwritten* and the 
EDITor Mill proceed to the next item in the list* if any* to the next line 
in the initiating- PRDC* if any* or to TCL. 


Forms symmetrical with these noted above include 


FS(NEWFILENAME NEwITEMNAME 


F I 01NEWFILENAME NE WIT E M N A ME 


FSC(NEWFILENAME N E WI T E M NA Mt 



The left parenthesis must immediately foilow the i or S» because the 
delimiter which specifies that t his is not a file reference is a blann. 
It is therefore possible to generate items commencing with a left 
parenthesis in the file which you are currently referencing. If something 
yet.5 lost* that is where to’ Look. Note that item-ias may have embedded 
blanks; in order to retrieve then; in the EDITor* surround tne item-id 
including the embedded blanks with quotes* and trie item will appear. 


The FI anu FS commands with a new item or file reference wilt not 
overwrite items with the specified name which are already stored in the 
reference file. Instead tne ED'ITor will respond with a rather cryptic 


CMND ? 


and return to the prompt character. In general* anything whiefi the E01Tor 
either does not understand or of which the EDITor disapproves will result 
in CMNO? error message when the FI, FS, or EX processes are Involved. 


Should you wish to overwrite an existing item, then the forms FIG ana FSG 
are available* in tne tradition of the 0 option used by the copy 
processor. Again, tne left purentnesis must immediately follow tne U for 

the reasons noted above. The processor wit I not recognize a lower-case 

’o’. 


1.4.7 EXTENSION TO THE EX COMMAND. 


'The purpose 
if one was 
the EDITor 


o f t n e £ X 

editing a 
entirely. 


command is to exit from an item. A problem occurred 
long list or the whole file and wished to exit from 
The only facility available was to BREAK and END. 
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R8G uses the extended form EXK (K for kill)* which will cause the editing 
process to proceed to.TCL or the PRGC which called the EDI Tor. The exit 
process will not recognize a lowercase 'k'. 



Upon 

i tern 


exit from the 
exited* rather 


EDITor* the processor now 
than simply printing 'EXIT 


specifies the name of 


the 


1.4.8 An extension to the X command. 


The X command is used to reverse the effect of the update 
instruction. The XF command is now available to reverse the effect of ail 
updates executed since the last buffer exchange (F command). 

The ? command now displays the item-id of the item currently being 
edited* as well as the current line number. 


1.4.9 Assarted EDITor supervision facilities. 

There is now a check which does not allow items which exceed the maximum 
allowable item size to oe filed. A message is printed which notes the 
condition* ana the number of bytes by wnich the item in the EDITor buffer 
exceeds the maximum item size. iycte that the maximum item size is less 
than 327b? bytes* and that the buffers available to the EDITor are about 
53000 bytes* subject to a C0LD-5T ART option. 

Associated with this feature is a new command* S ? * which causes the the 
size of the item which you are currently editing to be displayed. 


4.10 An a sio e on the construction of null attributes. 


There are three ways to create a null attribute or line. The first is to 

generate a line with some text*- ana then to- replace that text with a null. 
The second is to use the Insert command. This is uone by typing an 'I* at 
the p r ono t * followed by a Plank* foil owed t-y a carriage-return. This will 
insert a nil I attribute at the current location ano return to the prompt. 
The thira allows the creation of several null attributes with a single 
input line. Fur each null attribute desired* s imply include a CJNTRGL-up- 
arrow in the line. This has trie effect of including an attribute mark in 
the text* ana is useful for the creation of data definition items. 


1.4.11 An aside on clearing ana trimming the right end of the line. 

If a replace statement specifies an attribute mark as the second string* 

then all of tide line to the right of the last character before the first 
c n a r a c t e r in the string in the line which matches the first string 

specified by the replace statement will disappear. 

A field of clanks has a special place as the first string in a replace 

statement. The. processor *iiI search for a string of blanks of the same 

or greater length in the line. The peculiarity of blanks is that the 

processor takes the line to', oe implicitly’ padded to the rignt with an 
^ indefinite numoer of blanks. It will therefore take any string of blanks 

m long e r than the longest string of -clanks within' l he line to mean the ena 

9 of the line. It is therefore possible to trim ail trailing blanks off an 
item using the form 
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R 10 0 0 / 


// 


or 


R1000/ 

(• 

^^Ppr esuining 


/ A 

that the blank string 


is sufficiently long# 


l.**,12 Clearing the left end of a. line, 

It is possible to clear the left end of a line by replacing a string of 
a * s of necessary length with a null* as in the example below. 


.032 This is a dog. This is a cat. 

.R/aaaaaaaaaaaaaaaa// 

.032 This is a cat. 

Clearing the left 


Given the line* 

to remove the first sentence 

will ye i I d 

to remove the first sentence 

end of a line. 
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1.4*13 THE PRt ST ORE FACILITY 


'The prestore facility allows the storage of strings of EDITor commands* 
the execution of the string by using the name of the string as the 
^^^command. The allowable string names are P 0 * PI* • • • * P 9• .There are 

therefore a maximum of ten prestored commands available at any one time* 
Further* each prestored command is allocated 100 bytes* so that* if one 
wishes to generate a prestored command which exceeds 100 bytes* simply do 
not initialize tne command whose name is ordinal Iy next* In.other words* 
if PI is 150 bytes long* do not use P2* This may be inconvenient on rare 
occasions* but it makes things run faster. 

In order to create a prestored command* type in the name of the prestored 
command* PO* PI* •••* P9* followed by a space* followed by the first 
command to be executed* followed by the prestore command delimiter* which 
is a start buffer mark (X'Fb 1 )* and which may be input by typing CONTROL-! 
(control-left-square-bracket) or ESCAPE (esc)* followed by the next 
command* and so on* Any valid command is usable* including prestore 
command names* 


PO L22 This is loaded when you enter the 

EDITor. it has the following 
s y n o n,y m: 

This allows the traditional 

L22< to be uone by P<* which 
is generally convenient* a e i n g n e x t 
to the carriage-return key. 

PI RI 00/ uLG /€ A T[fik100/dog/c a 11 P I This has the effect of changing 

. dogs to cats in the first hundred 
lines of text. 


Creating si m pie prestores. 

In the as o vs exampl.es* note first that 1 P 1 is a synonym for 1 PO 1 * It is 

automatically loaded with 1 L 2 1 at entry to the EDITor. PI through P9 are 

null a t " entry. Executing them will cause a C h hoi response* All 
prestores createc since the entry to EDITor by use of the EDIT verb are 

retained, until tne EDIT v e i b is exited* Any of them may oe changed oy 
creating another prestore command string with the same name* The 
r r €• stores n e r s i s t fro m item to item. whether the EDI To r is using an 

explicit it e m list* a selected list* or’ the whole file* 



If one is n o * n g t o u s e a v restore command for a repetitive task* it may 
either oe activated each time it is to oe used* or it-as ay call itself* at 
which time its termination conditions must be considered. A prestore 
command which calls itseit will terminate only when it runs out of items 
to process. This means that a prestore which calls itself must have an 

LX f El, or ft it tne command string. If it does not have sue n an item 

iteration command in the string* it will loop indefinitely on the current 

i t em • I n o on I y e x i t f r ok. t. h i ^ c onu i 1 1 on - i s a ERE A**- ami E^u ♦ In e p r i ma r y 


use oft he prestore call* ng -itself is to manipulate many items witn a 
single instruction string initiated once. It is particularly useful for 
searching for specified strings in text files and replacing them as 
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necessary. The following example searches a BP (BASIC program) file for 
the name GENERAL.LEDGER. 



ED BP *< 

ITEMNAME 

TOP 

.PI _ 5 0 0 /CENERAL.LEDGERIEXIPI 

.PI 


EGI nnn 

•ITE'TNAME* EXITED 
NEwITEMNAME 

TOP 


Edit the file. 

The first item. 

Standard mark. 

Define the search. 

Initiate the run. 

At this point the EDITor will 
exhibit all lines in the current 
item with the desired string* 
then display 

the number of lines in the item 

The name of the next item. 

The top mark. 

All the lines with the string* if 
any* and so on* until the list is 
exhausted* at which time the 
process will return to TCL. 


A prestore command calling itself. 


The same maneuver may be executed to the printer by appending the (P 
option to the EDIT verb. In tnis case* all information which would have 
been displayed on the terminal will be sent to the printer. 



A . 13.1 


Displaying the current prestore comm an os. 


It is possible to display ai i current Iy ,in i t tai izec -prestcre commands by 
using the PD {Prestore Display) command. 


1.4.13.2 jsing pre stores in PkGCS. 

It is possiole to create the desired prestored command strings in PRGCS in 
the same manner that instructions are sent to the various processors from 
a PRGC. 


PQ 

HtU 5P * 

SUN 

HP 1 _ 5 00/ Gt N EA L . L c L- u t K < 
hip i < 

p 


The PR DC definition. 
The vero. 

Turn the stacK on. 
Specify the prestore. 
Execute the prestore. 
Execute the verb. 


D e t i n i n y 


V 


restore in a P k U C < 


The example arove assumes that a iist is in existence. The verb 

activation may include an explicit item list or specify the whole file 
using the conventional asterisk. On entry to the first item from the EDIT 
vero* the prestore is automatically set up* ana is available for use. All 
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ten prestores may be initialized tnis way* allowing the development of 
powerful customized EDITor commands. Further* it is implicit that the 
existence of this facility should ce-emphasize the use of BATCH-strings 
inside PROCsfor batch upoates* since the ability to prestore strings of 
commands* and to create multiple prestores provides tne user with many of 
the facilities in bATCH. 
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1.5 


ENGLISH 


| ^ 



This section will discuss such changes to ENGLISH as may be of use to the 
user* ana it will attempt to extend certain sections of the existing 
current ENGLISH, aocurnentat ion which are excessively opaque or thin. 


The primary effort which has gone into ENGLISH has peen the clarification 
of the code. This is in general transparent to the user* but results in 
speed improvements in some areas* predictability improvements in other 
areas* ana symmetry improvements in still other areas. 


1.5.1 EXTENSIONS TG ENGLISH. 


The following syntactic extensions to ENGLISH have been made. 

There is now a GSI.NG connective which allows the specification of ah 
arbitrary file as the dictionary from which oata definition attributes are 
to be retrievea. 

In a I I c 3 s e s the master dictionary is checked for for any data definition 
items not found in the specified dictionary. If found* they are then 
included in the ENGLISH compilation. 

Selection iterns may now take N^T and Ea£H connectives for a single 
selection criterion. Further* a NUT connective allows a value string. 



SSElECT will now consistently allow aata arguments 

M u I t i c o I j ts n a r labels will r, o * consistently stay 
columns. 


as output, 
within their 


assigned 


Data elenents with a length of zero may be totalled. Null multiple sub¬ 
values . may be displayed by the nun-columnar processor. 

Detail suppression and control breaks are now available for Y G D E I G 3 
processors. 

An L ? v * l. o a a Previous Value* command is available with F- ana A - 
correlatives. 


F-correlatives may now return strings up to 500 bytes in length. 

F-correlatives may contain conversions which contain embedded parentheses. 

The compiler now scans T-* F-* and A- correlatives more 

allowing some optimization of the runtime c o oe at compile 
allowing an error trap for some erroneous cases. 

The A-correI ative compiler now allows calls to A- ana f-correlatives,. 

The LPV commandis usable in A-correlatives. 

The L conversion has been modified so that there is an option which 

returns ins actual length cf each oata element. 

The Translate conversion has. been modified so that you may specify the 
particular multi-value in the target attribute to be returned* if desired. 


intensely* 
time* and 
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The translate processor has teen modified so that a broader range of file 
names will be accepted. 

If the combination of 'ONLY** ID-SUPP* and DET-SUPP is used* then the page 
header and' column header will be printed* followed by any errormessages 
(generated by the process. The process wilt not print a blank, line for 
each item processed. 

The headings and footings now know whether they are going to the printer 
or the terminal for centering purposes. 


Page numbers may be left adjusted in the page number field if desired. 

1.5.2 DATA DEFINITION ITEM RETRIEVAL. 


Historical 
the file 
sentence, 
definition 
could only 
diet ionary 
definition 
only files 
had a data 
and if tie 
the waste 
i n c I u-u e a t 


ly* ENGLISH has allowed data 
level immediately above the 
This meant that a data file 
items in the dictionary of 


definition items to be taken from 
file specified in the ENGLISH 
could only be LISTed using data 
that file* that file dictionaries 


be listed using data definition items in the account master 
anu that the master dictionary could only be listed using data 
items whicn it found in itself. Dictionaries of dictionary- 
could be tistea using internal data definition items if they 
levei u-pdinter which pointed bacn into the dictionary itself* 
Key word DI.CT was not used -in .the ENGLISH sentence* or using 
d let* o n a r y u a t a c: e f i n i t i o r It e rn s 
Lhe sentence. 


Thei e are two, modifications 
(specified. ■ aa.ta definition 
dictionary* then the 
new connective nas been 
ot hs r than t n3 no r r a i 
definition items. 


to this protoi 
items are not 
iaster dictionary is se; 

adueci which allows the specification of 
dictionary I eve I as the source of 


f t h e 

Key 

wore 

OKI KdS 

i i n 

. K 8 0 • 

I f 

ex p 1 i c i t i y 

feu n d 

i n 

th e 

r eferenced 

ched 

f o r 

t ti e m . 

Second* a 


a file 

, Pi ti‘ data 


1.5.2. I Master uictionary data definition item default 

If a uata definition is kJLiiliil £.b££if.i§d in the ENGLISH sentence* and 
the key <c-rd D1CT is not in the sentence* and the data definition item is 
not in :n e uict unary of the file referenced by the sentence* and the data 
definition i temus in 'the master dictionary of the account* then trie data 
definition i Lem founn in the mastsr dictionary will oe included • in tne 
ENGLISH compilation. This is useful for data definition items which are 
of global use* for exam:le* SIZE* which is defined as 

A A 9 N V D A j | t h j_ 6 1-, lj T HAA A A A A R A 1 k i 

The substitution of master dictionary data definitions does not occur if 
the default data definition items are requested (1* 2* and so on). 


u . 5 . c. * 2 lie us i u G connective. 


I f m o 

’ 2L O 0 c Q 


are: 


f i t x i b i ! i t j is ubSifto?. there i s -a U d Ih G c o n n ec t i v e 

t j Inc set of connectives avai iatie to ENGLISH* The 


i cn nas ueen 

legal f o r m s 
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USING DICT FILENAME 


USING FILENAME. 


The first references the dictionary of the referenced file; the second 
references the data-level file FILENAME. Note that the data-level file 
|may be of trie form FI LL'NAMt.SURF iLE^AMt. In these cases all data 
definition items Mill be taken from the file and level referenced by the 
USING connective. except those data definition items which default, to the 
master dictionary, as above. 


Only one USING connective is allowed in an ENGLISH sentence. If the USING 
connective is used. it must be immeai a teIy followed by either DICT 
FILENAME or FILENAME. The source of tne data processed remains specified 
by the conventional file name element in the sentence. Q-pointers are 
usable for either or both references, of course. 

Default data definition items will come from the file referenced by the 
USING connective. 


1.5.2.3 Use of the USING connective. 



The intent of the USING connective is. first, to allow the use of tne 
contents of a dictionary on a structurally unrelated file. It has the 
effect of giving different users access to different pieces of data within 
a common file by means of different retrievai locks on different 
dictionaries, or. more accurately, dictionary eauivalent files. It allows 
separation of data definition- items ay function anu meaning. It allows 
the use of a test dictionary during development in order to avoid the 
collection of. incorrect, ’obsolete, anc intermediate data definition ite'nis 
in the oermarient file dictionary. It allows the use of existing data 
definition items on new. temporary or test files without going through the 
COFY routine. A few syntactic examples follow. 



LIST u ■'< K F i L E USING uICT TESTL IC T The data source will be w 0 R K F IL E . 

The data definition items will 
be retrieved from DICT TESTDICT. 
Tne default data definition 
it e ms will oe used. 

LIST DICT wORKFILE USING DICT LuKKFlLE 

The data ana data definition 
items have tne same source. 

i_ I S T inJ\i(F ILt US-1 MG A u k K F IL E . < ■ F t i C I I 

Trie data corr.es from to0RKFI LE • 

The data uef in i tion j tems come 
from- a ■ o-a t a — i c v e 1 subfile of 

wORKFILE named wFDICTl. There, 
may b jj an inctef ini te number of 

t h e s e • 


Examples of the USihG connective. 


This facility will probably be of more use during system development or 
modification than in a stable application. It could oe used in a stable 
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application in order to control who has access to what data within each 
record within a file. The spreading of data definition items could be 
equally useful for the update case if a dictionary-uriven update program 
is used. This is probably best accomplished if each class of user has an 
actual account rather than separate U-pointer synonyms wnich log onto the 
actual account. In this case each account has U -pointers to the relevant 
^ata files* and associated D-pointer dictionaries which contain the data 
definitions items to which that class of user is privy. This necessarily 
leaas to a heavily PkOC-criven app l i cat ion * whi cn is also useful for data 
security. 


1.5.2.4 The ITEM-ID definition with Q-pointers to the data file. 

The file definition item in an ENGLISH sentence allows the use of 
attributes 7* 9* and 10 as meaningful elements, in the data definition. 
The laoel comes from the u- or G-pointer name Decause attribute 3 of the 
D- or U - pointer is in general otherwise occupied. Attribute 2 is an 
obvious force to 0. Note that the selection* sort and output processors 
all ignore attribute 6. The selection and sort processors take the item- 
id as it is; the output processor allows the use of an attribute 7 
conversion. 



The justification is of importance to Doth the sort ana output processors* 
the field length is of importance to the output processor* especially if 
trie i tem- i us are significantly longer than the file name or its nominal 
field length * anu especially in the columna/ processor. Note that item- 
ids uo not fold* unlike other data processed by the columnar processor. 
A I I • o-f tne characteristics of i tem-1 d handling may be gotten around Dy 
using a data definition item wnich references data attribute 0 with Iu- 
SUPP. 

In the case that a G-pointer is used to reference a file* the definitions 
in attributes 7* 9* and 10 in the (.'-pointer definition take precedence 
ever trie same at tr i butes i ri the u-oo inter if they exist in the 0-po inter. 
Those tnat uo not exist in the G-pointer will be retrieved from the D- 
po inter. In the case that they uo not exist in either* attribute / wi i i 
be defined' as null* attribute 9 will become L and a1.1 r i bu t»e 10 will become 
9. These defaults will bt taken for all data definition iterns processed 
cy t he BNut IS t compiler. 


This a I I 3 w s the creation of mu iti p I e Q-pointers which treat the it e m-i ti 
field in different ways* as may be convenient. it remains that G-pointers 
r ecu ire at most that trie first three attributes oe defined. 
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1.5.3 


THE SELECTION PROCESSOR AND ITS EXTENSIONS 



This section is int e n ded to clarify the 
as well as note the extensions to it. 


action of the selection processor 


1.5.3.1 Item-id selection. 

ENGLISH allows the following item-id selection protocols. The default is 
the whole file* or the item-ias specified in a list if a list is active. 
Restrictions may be put on the item-ias returned in two ways which are 
syntactically similar* but which operate in different'ways. 


1.5.3.2 Explicit item-ias. 

If explicit item-ids are specified* then only those item-ids will be 
returned. If there is a list in effect* it will be ignored. 

Explicit item-ids are specified as follows: 

LIST FILENAME ' I TF. M 1 • ' I T fc M2 * ' I T E M3 • 


o r 


LIST FILENAME "I T£ M 1" "I T EM2 ""I T E M3 " 
or even 



LIST 


FILENAME \IT E Ml\\IT L M2 \\l T E h3\ 


Each of these will yield a listing of the three items* IT EMI* ITEM2* ana 
ITFM3. The processor does tt,is ..y retrieving each of these items directly 
from the tile referenced. Tne collection oi explicit item-ids becomes, a 
list* wnich ' the processor uses to obtain the next it e m-id until it is 
exhausted, at which time the process terminates. 


The delimiter * is reserved fur item-id. specification. The delimiters " 
and \ are normally useu ror value specification* but will be taken as 
item-ids under certain circumstances. 


PR El 
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1 • 5 • 3.3 11 e in- i d tests 


ENGLISH 31 so allows tests on item-ids. Be aware that all tests are on the 
item-ia as it stanos in the file. No conversions or correlatives will be 
^applied to the item-id before the test i £ made. 

The specification of an item-id test rather than the retrieval of a 
specified set of items is done by including a relational operator* 
hereinafter referred to as a relational £2QQ££.i.i^.£» in the item-id 
specification string. For example: 

LIST FILENAME ' I T E M1' = • I TEM2••ITEM3• 

or 

LIST FILENAME " I T E M1 *' H I T E ft Z " = "I TEN 3" 
or even 

LIST FILENAME = \ I TEM1\\ITEM2\\ITEM3\ 

will all have the same effect. ENGLISH will search the whole file* or all 
the Items in a list if there is one in effect* looking for items which 


have 

the item- 

ids I 

TE Ml , 

I I fc M 2 * a n u I 

TEM/3. Thi 

using the e 

x p i 

ic i t 

i tern- 

id reference gi 

ven above* 

w hen 

you know 

w h i c h 

item 

-i cs you want. 


The 

intent 

o f 

relations 

i connectives i 

s to allow 

f o r m 







LIST 

FILE H A 

y c' 

< ‘CAT* 



w h i c 

h w i t 1 

h 

a v e 

t h e 

effect of s 

electing 

a i c h 

a n u rn e r i 

c a 1 

i y 1 

ess 

t h a n C A In presuming t ha 

ju s t 

ifieJ ♦ 

fh 

e tui 

1 eft 

ects or just if i 

cation wi1 I 

N o t e 

t n a t 

i n 

the 

e x a Pi o 

ies a d o v t o r 1 

y one re 1 

i n c i 

u a e d * 

I n 

t h .a t 

casei 

ail the e 1 e .11 en t s no t pr e c 

auto 

i:iu 1 1 o a i 

i y 

a s s i 

g n e u 

trie con n e c t i v e 

In 

ENGL 

i S H in 

t n o 

s e c a 

se s m 

nen values are 

usable* 

T h e r 

e nee u 

no t 

o e 

spaces between the 

i tem or va 1 

name 

f data 

ce f 

i n i t i 

on items or connect i 

ves may be 


items whicn are 


in the input sentence* as in the for iii 
*" I I £ V\ 1 " 

In all other cases all elements in the sentence which are to be retrieved 
from a diet ionai y or dictionary-equivalent file must o e surrounded by 
blanks. . 

It is possible to specify either a list of item-ids for retrieval 2 £ to 

specify a test on i tem-i ds using this i; echan i sn«. It is not possible to 
retrieve certain items oirecti y anu to test all the other items for 

ad"; s s sab i I i t y using only item-id tests. In other words* the i ten-id list 
is either a list of explicit item-ius or it is a sequence of values 
against which to test each item-ib in the file. 
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1.5.3.4 Trie use of delimiters in the ENGLISH sentence. 

In the ao o ve examples the delimiters ** "* and \ are all used equivalently 
to delimit' item-ids or values, as the case may be. In general* only the 
delimiter ' is reserved tor item-ids cr item- id-re I ated values. The "and 
\ maybe used for values related to data definition item selection 
|ttcriteria ana print-limiters as well* although they prefer to be associated 
with the data selection criteria rather than with item-id selection 
criteria. In general* values delimited by either " or \ will be treated 
as item-ia selection criteria only if they follow the file reference and 
precede data definition items. 

The delimiter ' will cause the value which it surrounds to be treated as 
an item-id selection criterion wherever it may be in the sentence. 


1 . 5 . 3.5 Item-id selection criteria. 

Presume that we have a set of values with an associated relational 
connective* so that ENGLISH is scanning the whole file in order to test 
the item-ids for acceptability. Be aware that the item-id test is 
logically AhU ed with all other selection criteria. If the item-id fails 
the i ten- i d test* the item will be discarded. If one wishes to 'or' an 
item-id test with other selection criteria* then a data definition item 
must be included which references the item-id. For instance: 
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Consider the following data definition items 



0 


1 

DDI 

i tem-i d 

001 

A 

001 

A 

DDI 

t y p i f i er « 

002 

0 

002 

1 

AMC 

specifier 

003 


003 


nu i 

1 label 

004 


004 




005 


005 




006 


006 




007 


007 




003 


003 




009 


009 

L 

Justification 

010 

10 

OlU 

10 

Length 


and the following ENGLISH sentences: 


LIST MO < "CAT" rl IT h 1 = "D" This will select all items whose 

item-ids are a IphanumericaI Iy 
less than 'CAT* ANQ which have a 

* D' in attribute 1. 

LIST MO WITH 0 < "CAT" WITH 1 = "D ,, This will select all items whose 

item-ids are a I phanumer i ca I I y 
less than 'CAT* £& which have a 

* D * irt attribute 1. 

LIST MU WITH 0 < "CAT" AND WITH i = "D" 

This will select all items whose 
item-ics are a Iphanumerica I I y 
less than ’CAT* AND which have 
a*0* in attribute 1» as in the 
first case. 

LIST MO ,-i I T H 0 < "CAT" AN 0 1 = "u" This is erroneous. 

It will have the effect of 
selecting all items whose item-ids 
satisfy the CAT criterion* as 
above. The rest of the sentence 
has to ao with print-limiters* 
wnich are taken up below. 

LIST *0 < "CAT" AND WITH i * "0" This is erroneous. 

It will terminate in the ENGLISH 
compiler with an error* because 
the AM) connective must be followed 
by another value which may be 
AuUec with CAT* and because 
the. AND connective may net 
immediately precede the first 
wITH connective in the 
ENGLISH sentence. 


The relationship of I tern-io selection criteria to data selection criteria. 
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1.5.3.6 An asioe on item-id structure. 



In TCL the universal delimiter is a blank. Verbs* file names* 
and data definition names are normally delimited by blanks, 
verbs wnich reference files anc items ( will take a string of 
which is delimited by blanks to be the file name or one of the 
depending on its location in the command sequence. 


connectives 
Non-ENGLlSH 
character s 
item names* 


If one constructs an ENGLISH sentence which references a data definition 
item which it cannot find in either tne specified fiIe dictionary or the 
master dictionary* it will then generate another item-id by taking the 
item-id for which a record did not exist and concatenate the nexi string 
delimited by blanks in the sentence to it* with a blank between the two 
character strings. This will now be used as an item-id. This is why the 
error message which is trying to tell you that the data definition item is 
not on file may includes more elements of the ENGLISH sentence. For 
example* if in the example below* the data definition item DOG is not on 
file* 


LIST MD CAT DOG RAT 


the error message 

I2AI THE WORD "DOG RAT" CANNOT RE IDENTIFIED 


will oe returned. 


The sequence of concatenated strings wilt terminate at the end of the 
/"' sentence* or at the first connective which succeeds the unidentified word* 
l^^or at the first value or item- id which succeeds the unidentified word. 

uhat this means is that i n general a blank .is a character which is 
allowable for item-ids in the system., it you. wish to EDIT a item-id which 
includes one or more alarms* enclose the string in one of the value 
delimiters above. 


You may also use the delimiters wit h in a string enclosed in delimiters. 
Simply use a delimiter which is not cart of tne item- id as tne value 
surrounding delimiter. For example: 
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!• If D3G‘ RAT is an attribute definition item in MO* then 

* LIST HD DOG RAT will return the one attribute 

J definition item whose name 

I is DOG RAT• 


In order to modify the item DOG RAT* use the form 


EDIT MO 

"DOG RAT" 


which will obtain 

the item. 

If you 

have an item 

namea G'rlARA* 

use the form 


LIST MO 

"O'HARA" 


This will return 
. O'HARA. 

the itern 

Similarly* tne form 




SELECT 

CGSTUMERFILE 

wITH LA STNAME 

"O'HARA" 

Will find all the 
file COSTOMERFILE 

0'HARAs » n 

• 


Examples of infrequent but legal item-ids. 

T h ere are c haracters wh i c h are not acceptable for inclusion in i t e m- id s• 
N o n p .of the s y s t e u delimiters is a i I o * a o i e • An attempt to retrieve an 
i t e m - i d which contains a system ae I in* i ter will have the effect of 
tenrii na t i n g t h e k e y a t the delimiter. in other w ordSf if you have an 
i t e ii - i d with a s y s t e m a e limiter in it* it can be accesse a only by 
processors which use a sequential fife search ra trier than an item name 
retrieval. T r t s m e a n s t h at you can list it or select it out you cannot 
lDIT itt C0? Y it f o E l r1 1 i 1 1 or o t n erwise u p cate iti or r e tr ie v e it using 
a list. it can v e removed by using a file-to-file c c p y * since it w i 1 I n o t 
cop y to l h a new file. T he f r a g m e nt of the errant it e m -id up t o t r re 
delimiter will be reported as not oeing on file, at the ena of the copy 
process if the copy is oriven trot a selected list. 

The control characters < X 1 00 s through X 1 IA 1 ) are generally inadvisable* 
a I though they may work o c c asio n ally. 
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5.3.7 Selection by data values 


ENGLISH nas always supported the capability of selecting items based on 
the values contained in cata fields. The discussion below includes a 
recapitulation of the historical characteristics of the selection 

processor with a focus on subtitles* and a consideration of extensions 
vhich appear in KbG. 

Data definition items are marked as selection criteria in the ENGLISH 
sentence by preceding the data definition item name with the connective 
WITH. The standard form of a WITH phrase is 

WITH {NOT}. {EACH} DO I NAME lvalue string}, 

which is called a selection criterion. For convenience, the connectives 
NOT and EACH following the WITH shall be referred to as selection 

modifiers. 

The basic form of selection, 

WITH DO IN A HE 

will check for the existence of at least one non-null value returned from 

the item as a result of the directives contained in DDINAHE. The item 

will succeed if there is at least one non-null value. The modified form 

WITH NOT ODINAME 

will succeed if there all values returned are null. The addition of the 
connective WITHOUT in k 77 allots the more natural form of the above: 

WITHOUT DulNAHE 

which has the s a me effect. The n o uif i e a for m 
WITH EACn uDINAHE 

will succeed if each value returned is non-null. The form 

WITH NOT Each ■dd.iname 

or 

WITHOUT EACH GUI NAME 

is an extension for k t u. it has the effect of accepting a l I t t em s wnich 
have at least one null value returned. 

The meaning of the tern 'value’ in this context is considered below. 


• 5.3.7.1 Evaluation of data by the selection processor. 

The selection processor processes the data according to attribute cs of the 

data definition item. That is, it executes any conversions or 
correlatives w h i c t> a r e t n a Ur itute . The resuit of this calculation is 
returned to the selection processor. The conversions or correiatives 
which may be in attribute 7 of the' data definition are not applied to data 

This manual is prepared for TEST PURPOSES 
It is NUT FUR ATTRIBUTION. 16:37:00 30 HAY 1980 

PRELIMINARY CHANGES DOCUMENTATION RELEASE PC- REVISION 1 PAGE 30 





within an item. The contents of attribute 7* howeverT may have a 
significant effect on the success of tne selection process as we shall see 
below. 


5.3.7.2 


Obtaining a value to test. 


The selection processor will ignore leading null sub-values within each 
value. That is* if an attribute of a data item contains multiple values* 
which themselves contain sub-values* as below* 


*\\3\4]6\\7]1\2\3 1 J\\a 


then the processor will retrieve one data value from each value. In this 
case the values returned will be: 

3* 6; i; null* null* 

whether the search is based on a direct oata call from the AMC in 
attribute 2 of tne data definition item or on a virtual data call by an F- 
or A-corr e I at i v e. In either case* if a request for the next value results 
in a null followed by a suo-value in ark* the processor will proceed to the 
next value in the string. it will return from the data search. if a non- 
nuI I data value has been retrieved* if it encounters a null value followed 
by a value mark* or if it encounters a null value followed by an attribute 
mark. 


If the search results in a null a'a 
value test routine. If a non-nui I 
will then execute any conversions 
definition item. Tne data reset bin 
then be returned to the value test. 


ta value* the process returns to the 
data v a T u e i s v returned* the process 
remaining in attribute 8 of the data 
y from the conversion* if any* will 


This is tne 'value' referred to above. note particularly that onj.^ the 
f Uu.2~0kii sun-va£ue is returned. If another value is requested* then 
trie next value is taken from the next value* tnat is* from the right side 
of the next value r a rk if there is one. All sub-values which follow the 
first non-nui I' sub-value are never inspected by the selection processor. 


L.5.3.7. 3 


Th 


test for existence. 


what occurs at trie value test level 
upon tne selection modifiers. If there 
null s u o - v a I tie is returned from the 
succeed. If anull value is returned* 
next value in the item* unless the last 


W 1 * 

a r 
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t h e n 


n testing fur existence depends 
no modifiers* then if any. non- 
m * the selection phrase will 

request the 


the tester will 


null value was terminated by an 
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n e r e q u i 
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Therefore 

* t n i s 
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election 
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If tne se 

lection 

modi tier 


i s NOT * 

then ail values 

defined by 

the. 

da ta 

tie f i n i t i o 

n m u s 

t 

b e inspe 

c 

tec i n 

orcer to succee d« 


If arty 

value 

1 s 

r e tur ned 
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i s 

non-nu 11 

r 

then the 

clause will fail 

• 




If the se 

lection 

modifier 


is £ ACh » 

then ail values 

de f 

i n ed by 

the 

data 


definition :n u s t 


i e Inspected in 'orcer 


> u c 


! e u 


If any value 


If both modifiers are used* «, IT H NUT EACH or WITHOUT EACH* then, the clause 
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will succeed if any value is null* It will fail only if all values are 
non-null* Note that this is an R80 extension in the interest of symmetry* 


-- 

« 

• 

! WITH DDINAME 

« 


succeeds if 




(VALJE1 

if NULL) 

OR ( VALUE 2 ft NULL) 

OR (VALUE3 # 

NULL ) 

OR 

• • • a 

WITHOUT 

DDINAME 


succeeds if 




S (VALJEI 

• 

* NULL) 

AND (VALUE2 = NULL) 

AND (VALUES 

= NULL) 

AND ... : 

« 

! WITH EACH DDINA 
* 

ME • 

succeeds if 




* 

! (VALJEI 

* NULL) 

AND (VALDEZ it NULL) 

AND (VALUE 3 

» NULL) 

AND ... S 

! WITHOUT 

EACH DDINAME 

succeeds if 




! (VALJEI 

= NULL) 

OR (VALUE 2 = NULL) 

DR ( V ALUE3 = 

NULL ) 

OR 

• 0 • a 


Success conditions for >iitr» and its modifiers 
under the test for existence* 



WITH DDI 

NAME ■ 


f a i i s' if 


■ ■ ■ .. .- — -■ a 

i 

i 

i 

(VALJEI 

= NULL) AND (VALUE2 = 

NULL ) 

AND (VALUE 3 

= NULL) 

« 

AND . . . 1 

4 

WITHOUT 

D LINA ME 


fails if 


• 

i 

! (VALJEI 

*» N U L L ) Li K i V A l O t 2 fr T 

•; U L L ) 

UK (VALUES n 

NULL) OR 

0 0 0. t 

1 il I i r' C. U 

H ui) I NAME 


fails if 


« 

♦ 

! (VALJEI 

= NULL ) JR ( VALUE 2 = ■! 

•■ULL ) 

OR (V ALU£3 = 

NULL) (J ft 

4 

1 

s 

• • • 8 

* 

: WITHOUT 

E AC H DD IN A M E . 


fails ir 


I 

1 

t 

i 

! (VALJEI 

U NULL) AND (VALUE2 ft 

NULL ) 

AND (VALUES 

n NULL) 

AND ... J 

i 


F afI a re c on nit ions for With ana its mc di f i er s 

unuer the test for existence* 
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5.3.a 


Tne value string. 


In the syntax ot 
which h3s not 
Existence ass ume 
a I u e phrases of 


the WITH phrase above* there is an optional value string 
oeen mentioned since* although all of the tests for 
a null string as the value. A value string is made up of 
the following form 


{relational connectives} VALUE. 

The relational connectives are optional in the sense that the relation 
will default to if there is no relational connective preceding the 
value. 


A value is of the form 
11 text string" 
or 

\text string\ 

Remember that the delimiter * will always specify an item-id reference. 

The contents of the text string may oe any characters with the exception 
of the system delimiters. Avoid the control characters if possiole. 
There are three special symbols* a, [, ana *] which have a special meaning 

to the selection processor* ana will he considered below. 

|5.3.b.I The relational connectives. 

Tne master dictionary contains definitions ot the usual relational 
connectives: * * 4, < * > * *> » > = * < = * =< * t L * Nt » G 7 * CE * LT * and L t . 
These m ay• oe used in any combination except with the condition «* wnieh 
must oe asm; by itself. Note that ali normal combinations are already 
defined. Tne form - < may be used as well as = <». for example. hole that 
the space between the connectives requires that two loon-ups must ce d one * 
while the = < form is retrieved in a single mas t e r Dictionary reference. 
If you ha v e a syntactic preference for the form <>» you .nay copy the item 


* s • in 

the master diet lonar y t o 

the 

i t e m 

•O’. 

The 

operators 

a re 

logical 1 

1 i ecu? vaient. 
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h t 

of as 

an 

o a 

.t nut ccnversi 

c n i 

a e c * l. s e i h 

. f 

> a . I 

S w h , f t j t 

i s O' o s i n e a to 


f teC t m 

r 

o r 

t fi i s reason, 

t i \ c 


ENGLISH compiler will execute an inverse conversion on the data values 
defined in the value string, so tna t the output conversion does not neeu 
to oe done for each value in the file referenced by the data definition 
iter.. Tne com pi ler then throws away the contents of attribute 7. 

The' ENGLISH comp i ler w i I I net attemet to execute an F- or an A-cor re I at i »e 
|i n attribute 7. Tnese will be lynorec. 

There are conversions which will yield unexpected results* however* and 
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should be avoided 


1.5.3.9.1 Allowable conversions -- the date. 

There are conversions which are of use? primarily the date and time 
conversions. The aate conversion will take a date in display format and 
return tne internal form* which is a decimal number representing the 
number of days since December 31* 1967. In this case you would not wish 
to execute a date output conversion in attrioute 6* since it is unlikely 
that you would ever get a match. Note that an input date conversion will 
only transform the external form of a date into the internal form* and 
that an output conversion will only transform an internal date into the 
external form of the date. The only time that an input conversion is done 
in ENGLISH is for the evaluation of values associated with selection 
phrases according to attribute 7. 

It is preferable to do the data conversion associated with selection in 
attribute 7 because it only neeas to be done once* at compile time* and 
because* if it is done in attribute tt on each value* it will be necessary 
to remember the precise form which will result* ana because the form which 
derives from attibute 6 will be evaluated according to the alphanumeric 
form of an external aate* rather than in the normally-desired numeric form 
of the internal aate. The internal date is represented as an increasing 
Integer* so that less than ana greater than relational connectives have 
the expect-ed meaning of before and after. The external date does not have 
this characteristic. 


1.5.3.9.2 The time. . 

Time conversions are allowable. Again* it is preferable to use the 
attribute 7 form. Time is represented in the machine as an integer which 
is the time since midnight in seconds. 


1.5.3.9.3 The irasK conversions. 

In general tne forms . tfk* ML* arid* ML will treat only the scaling and 
decimal location characteristics available with these masks. Nothing else 
wilt be tcucned. This r.cans tnat they will have an effect only if they 
are immediately followed l / one or two nur.ter i c digits. They will have an 
effect only on a value string which, represents a number. If the value is 
a number* it is scaled and the decimal place is attended to. Remember 
that the internal form is an integer. That is* there is no decimal point 
in the number. If there are some numeric digits at the front of the 
value* then these will be taken as the number* and the rest of the value 
will be t’r; ro»n away. if tne. first character of the specified value is not 
numeric* then the value string will ue taken without modification. 

Thus* if attribute 7 a as a no* or r,u conversion in it* numeric values 

are recon,menued. 


1.5.3.9.A Dpher masking functions. 

Since the functions of • the form C a 
stripping rion-aas i ssat I e cnaracters 

there is no point in using them, 
meaningless. 
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'hCN ana so on have .tne effect of 
f roii the s t r i n g w h i c h they process* 
Clearly the inverse function is 








The MCXD (convert from hex to decimal) and MCDX (convert from decimal to 
hex) conversions have inverse functions* so that they are useable in 
attribute 7 of a data definition item being used for selection. The MCXD 
will convert decimal to hex as an input conversion* and the MCXD will 
convert nex to decimal as an input conversion. 


5.3.9.5 Translate conversions. 

If there is a translate conversion in attribute 7* then it will be 
executed as an input conversion. This means that the first of the 
translate attribute mark count riumDers in the translate syntax will be 
used. If the field is null, then the translate will return the item-id if 
it found an item-id. 

If the value specified does not yield an item-id* and if the translate 
option byte is an 'X'* then the value for which the processor will search 
will be a null. If the option o>te is a 'C', then the value for which the 
processor will search will be the specified value. 

vlhat the an input translate will nc£ ao is search the file specified by 
the translate for an item which has the specified value in the correct 
attribute* and return the item-id as the value. 

If there is a direct one-to-one correspondence between the source and 
destination items* then it is possible to have a set of -translate elements 
within the file which are an inverse transformation. That is* if you 
supply tie value generated by the output translation* and if that value is 
an item in the file which has as contents the item-id tne value which 
translates to. tne value supplied* then a translation in attribute 7 is 
valid. -or instance, * 


In a file «e may cai I CUSTOMER* 

23e Pacific Printing The item names. 

DU 1 Pacific Printing Oui 232 The translate references. 

Tnen if attribute 7 of the data definition item UUSTTRAhS is 

TCDS T GMER 5 C 51JI 

and the data file reference to Pacific Printing is '232** then 

LIST FILENAME wITH CUSTTRANS *• "Pacific Printing" ... CUSTRANS ... 

will yield the desirea result, because Pacific Printing will be 
translated into 232 for the selection, and 232 will oe translated 
into Pacific k ,f inti n c f c. r output. 


A translate which will work in a selection. 

If the output translate function which takes many different data strings 

ana translates ail of them into a single output result, requiring an 
inverse function which is multi-valued* then a translate in attribute 7 
is inappropriate, because only the first vaiue found by the attribute 7 
manipulation will be included in the resultant value string. In this 
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case* the translate must oe put in attribute 8* so that the processor is 
comparing the translated value to the value originally specified in the 
value string. 


^>•3.10 Summary of conversions for selection. 

It is generally a gooo idea to use the date and time conversion in 
attribute 7. The MCXD and M C D X conversions wilt work. The MR* ML* and MO 
conversions will work sometimes* .and will do strange things other times. 

The translate tnay possibly work if the data structure is just right. 

The various other masks and conversions which have no natural inverse 
functions will tend to fail in a data-sensitive way* and are not 
recommended. 

The processor will not even try to deal with A- and F-correI atives . In 
all cases the contents of attribute 7 are discarded during the compilation 
process. 






PRELIMINARY 
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1.5.3.11 Forming conditional values 


associated with value 
optional and they are 


[ stipulates tnat any leaning string is acceptable. 
a stipulates that any character is acceptable in this position. 

1 stipulates that any trailing character is acceptable. 

The test will terminate at this point with success. For purposes of 
evaluation* the inclusion of a special character forces evaluation from 
Ieft-to-right* on a character-by-character basis. For example* 


( 


0 


As noted aoove* 
specification: 
ot mod if iaoIe. 


V-HC3* dVICI > 


there are three special 

• - 'a', and *]'. These are 

have the following meanings: 


t • * 
They 


not 




* " £ 6 " 


*b* or 1 A3U6 ' or '123556 1 . 
= " 3 a-5" 


•335' or * 3 A 5' or '3*5». 


Will accept any data value which 
terminates in a *6'* such as 


will accept any three-character 
string which begins with a '3* 
and ends with a '5'* such as 


= "5 ] " will accept any str ing 

whieh starts with a '6'* such as 

*5* or '6 A b C ' or ’ 65V321*. 

= '* £ 6 ]" will accept any string which 

contains a ' h *» such as 

'k ' or 'ABCfc * or * t A bC 1 or ' A8C6XYZ* 


="£3a51" will accept any string which 

contains any three-character 
string which starts with a *3* 
and ends with a 1 5 * * such as 

*335* or * 305XYZ' or 'A6C3X5' or ' ABC3X5XYZ * 


use of special characters in selection values. 

There are certain forms which will not work. If the '£' is used in the 

value sate ification, it must oe the first character in the string* anu it 
must be the only * C * in tne string. If the character is used in the 

string, it. will terminate tne specified. strjn y at that point. Any 
characters wfiich may occur after a ' J * will never De inspected. The a may 
be used anywhere, arte any burnt er of them may oe included . in the value 
specification. The form * aaa' ray te usee to retrieve all three-character 
strings* for instance* although there is a conversion* ' L ’ * which performs 
this function . 
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1.5.3.11.1 The special characters and the relational connectives. 

The following examples use the relational connectives < (less than)* > 

• (greater than) and = * since the other permutations can de derived from 
these. , 

The case of equality is shown above. If the form 

WITH 2 < "5]" 

is used* the test is on the first character, and is straightforward. 

If the form 
WITH' 2 < ''15" 

is used* the test is on the last character* and is straightforward. 

If the form 
WITH 2 < "15)" 

then* if there is a '5' anywhere in the string* equality will be true* and 
inequality will fail. If there no '5* in the data string* then the 
condition 'less than' will hold if the last character is less than the 5* 
and the condition 'greater than' will hold if the last character in the 
data string is greater than '5'. 


Similarly* if. the string 
I the test which generates 
process reaches the end 


of actual data specified 
th<> type of equality w i i 
of the data string when 


s several digits long* 
be as follows: if the 
it is on the first real 


character of the test string* it will compare -those two characters aria 
yield .i result as acove. If the it is on a character other than trie first 
real character in the specified string* it will generate the result 
expected j I the compare were on the first K characters in the specified 
string against tne last h characters in the data string. 



•ktL 11 
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1.5*3.11.2 Justification and evaluation. 

If the data definition item is Ieft-justifi ed or if there is a special 
character in the value specification string* then comparison will . be 
alphanumeric. That is* it will proceed from left to right* and inequality 
( i I I be declared as soon as characters in the same location in the two 
trings are different. The collating sequence is that of -the ASCII 
character seti with the particular characteristic that numbers preceae 
letters* and capital letters precede lower-case letters. An absolute null 
is less than any character* including an ASCII null. An absolute null 
occurs when the end of a string is reached* with the result that 'ABC' 
comes before •ABCO 1 . Also note that blanks are the non-control character 
with the lowest value. 


If the data definition item is right-justified* and there are no special 
characters in the string* and the data striag and value string are 
numeric* then the test will be on the magnitude of the two numbers such 
that 12 > 2. If these were Ieft-justified* 12 < 2 because 1 collates 
before 2. If the data are not numeric* then they will be compared in the 
usual Ieft-to-riyht manner until either inequality is discovered* the 
strings terminate* or numeric fields are found. If both the data and the 
specified value are equal up to the start of a numeric field* then the 
numeric fields will be evaluated as binary integers and compared. If 
inequality is found* tnen the string with the smaller imbedded integer is 
accepted. If they are equal and both strings terminate at this point* 
then the strings are equal. If the strings continue with non-numeric 
data* tne Ieft-to-right process continues unti I inequality occurs or the 
strings' terminate. 
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1.5.3.12 Value strings containing many vaiue phrases 


It is possible to select based on more than one value. The relation 
associated with each value is the relational connective which immediately 
precedes the value. if there is no relational connective which precedes 
the value* then a default 1 =' will be inserted into the value string. The 
imp'licit' relation between the value phrases is 'OR*. If the data value 
must pass both of two criteria* then there must be an 'AND' between the 
two vaiue phrases. 



The relational connective default: 

... WITH X "A""C" "E""G" . is equivalent to 

... WITH X = "A" = "C" = "E" « "G" 

which will succeed if 

(DATA = "A") OR (DATA = "C") OR (DATA = "E"l ... 

where DATA in each case represents only one value which 
may oe returned to the value comparison processor. 
Therefore we may say* 

IF ((DATA * "A") OR (DATA * "C") CiK (DATA * »E") ...) 

then DATA IS TRUE else DaTA IS FALSE. 

A data value is said to succeed if the test returns TRUE. 
The cases of inequality are similar: 

... «11H X < "A" > "C" ft "E" <= "G" 

is equivalent to 

IF {(DATA < "A") Ok (DATA > "C") OR (DATA ft "E"> 

Ok (DATA <= "G" ) . . . ) 

Tnen DATA IS TRUE else DATA IS FALSE. 

(This particular case will succeed in all cases). 

OKed values with relational connectives. 
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1.5.3.12.1 The AND connective within a value string. 

If you desire to specify a range of values which wili be acceptable*.or a 
C I lection of conditions on a given data value such that they must all be 
'^Btrue in order for the condition to succeed* then the specified values may 
be ANDed together. The required form is: 

... value AND relational connective value. 

Forinstance, 


... WITH X < = "A]" AND >~ "Cl" will accept all values which 

start with A* B* or C* as in 

IF UDATA <= "AT") AND (DATA >* "CT")) 

then DATA IS TRUE else DATA IS FALSE. 


... wITH X = "IT" AND < "15" 


will have the effect of 
accepting all values with start 
with 1 and end with a character 

less than 5 * as in 


IF ((DATA * "IT") AND (DATA < "15")) 
then DATA IS TRUE else DATA IS TRUE. 


Examples of AND value specification phrases. 


1.5.3.13 The evaluation of one selection item. 

An indefinite- collection of value phrases may be ANOea together into what 
we ray call an AND value specification phrase. Further* several AND value 
specification phrases may be ORed together into what we have been calling 
a value string. 

Essentially* and AND phrase* which may consist of suo-comlitions* acts as 
a single entity which can either pass or not pass. For an AND -value 
specification phrase to pass* all elements must pass. within the string 
in general* that is, as amongst the GRed value specification phrases* if 
any element succeeds* then the selection criterion succeeds. 
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within a sentence 


5.4 The relationship of selection criteria 

It was just noted that if one ORed value specification allows a data 
element to pass* the selecion criterion will pass. It is possible to have 
^several selection criteria within a single sentence. The default 
connective between the selection criteria will be an OR* so that’ if any of 
the criteria pass* tne item will pass. This is of course modified by the 
selection modifiers NOT ana EACH. Prior to R8G the modifier NUT could not 
be used in the same criterion with a value string* on the grounds that the 
criteria in the value string could always be reversed to ODtain the 
complemeit of the criteria. It should be clear that value strings can be 
constructed such that the construction of their complement is at least 
thought-orovoking* if not time-consuming and unpleasant. Therefore* the 
NOT modifierhas been enabled so that it will cause the criterion to fail 
in the case that the value string succeeds arid vice versa. We may 
therefore replicate the taole of success and failure under the conditions 
of WITH* WITHOUT* WITH EACH and WITHOUT EACH which was displayed for the 
case of existence only. Note that the case of existence is equivalent to 
the value string u ""* although using the explicit string is inefficient. 
In the table below the form ' f* NULL' is replaced by the form 'IS TRUE'* 
and the form. *= NULL' is replaced by the form 'IS FALSE'* as values 
returned from the value test processor. 


WITH uDINAME <VALUESTRING> succeeds if 

"(VALJE1 IS TkUEI HR ( V A L U £ 2 IS TRUE) OR I VALUES IS TRUE) OR ... 
WITHOUT'UDINAME < V A L Ufc S T RINC > succeeds if 

(VALJEi IS FALSE) AhL lVALUE2 IS FAlSE) AND (VALUES IS FALSE) ... 
.■« I T si EACH oDINA'ht rvalue STRINGS succeeds if 

lV AL J tI iS TRUE) A Nu (VALUE Z IS T R U E) AND (V A L U E3 IS TRUE) ... 

WITHOUT EACH DO I NAME < VALUE SIR, I NO succeeds if 

(VALJEi IS FALSE) OR (VALUE2 IS FALSE) OR (VALUE 3 IS FALSE) ... 


Success conditions for WITH ana its modifiers 
under test against a value string. 
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WITH DDINAME CVALUE STRING> fails if 

(VALJEI IS FALSE) AND (VALUE2 IS FALSE) AND t V ALUE 3 IS FALSE) AND ... 
WITHOUT DDINAME CVALUE STRING> fails if 

(VALJEI IS TRUE) GR (VALUE2 IS TRUE) OR ( VALUE3 IS TRUE) ... 

WITH EACH DDINAME CVALUE STRING> fails if 

(VALJEI IS FALSE) OR (VALUE2 IS FALSE) OR (VALUES IS FALSE) ... 
WITHOUT EACH DDINAME CVALUE STRINC>fa i I s i f 

(VALJEI IS TRUE) AND (V ALUE 2 IS TRUE) AND (VALUES IS TRUE) ... 

Failure conditions for WITH and its modifiers 
under test against a value string. 


5.4.1 Selection criteria AND clauses. 

We nay naw consider the Denavior of the traditional AND clause. Note that 
there may be a maximum of 9 AND clauses. The sentence will be very 
difficult to comprehend long before it has acquired 9 AND clauses. 

We define the. term SELECT ION- CRITERION to o e c.f the form 

WITH {NOT} CEACHj DDINAME i<VALUE-STRING>>, 

sucn that each tests or.e data definition item against any value string, 
and modifies it as specified, across such data values as are available and 
are required, within one item. 

Then an AND clause is of the form 

SELECTION-CRITERION AND SELECTION—CRITERION AND SELECTION-CRITERION .... 

The criterion for success of an AND clause is that each SELECTION- 
CRITERION succeed, as per the table above. 


5.4.2 D3ta selection criteria. 

The data selection criterion is mace up of an indefinite number of 
selection -criteria which are urea together, wriich may include at most 9 
AND-c lauses ano any number if Uiveu selection criteria wiiicn are not 

members of ANO clauses. The condition for success of the data selection 
criteria is that at least or.e of tne selection criteria which are ukec 
together succeed. 


5.4.3 Item selection criteria. 

The condition for item selection is that the item-id tests succeed, and 
that the data selection criteria succeed. In other words* the item-id 
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test is implicitly ANDed with the data selection test 


1.5.4.A Some things which will not work. 


S' 


^he form 

1ST MD < "CAT" AND WITH 1 * "D" 


will not work because the item-id test is implicitly ANDed with the data 
selection criteria* ana becuase in this context the AND must either attach 
an item-id test value to "CAT" or generate an ANO clause baseo on a prior 
selection criterion. This will generate error message 71. 


The form 


LIST MD < "CAT" OR WITH 1 = "D" 

will not work because of the ImpIicit ANDing» and has been discussed 
above. 

If you desire the case ((1 = "A" OR 2 = "B") AND 3 = "C")» then it must be 
written in the following manner.: 

LIST MD WITH 1 = "A" AND WITH 3 = "C" WITH 2 = "6" AND WITH 3 = "C". 



Two data values cannot be compared by the form wITh 1 
system has only one temporary data area. If this is 
correlative can be generated of the furm F > 1» 2 J * » which 
value 1 when the statement is true* or the value C when 
false. The above form wool a be written ',<ITh 1 = 2? » "1 
probably more efficient than the alternative., would be. 


2* oecause the 
desirable* an F- 
will return the 
the s ta tement i s 
'. This form'is 


Returning to the relationship between the character surrounding a value 


a n d 

foil 

the t r e a t v: e n t o f t h e v a 
o w i n g e *a 1 e : 

i ue 

d y 

t h<= 

t: u 

GL I 

Sh c amp i 1 e r » 

we consider 

tne 

LIST 

* , Zj ,nf 'jG Mh iO u F IlENAML- m 

6 0" 

"60" 

■« I T H 

1 

• 




This 

wilt cori*p iie as thougn ' 

t h e 

foil 

o w i n 

G 

h a d 

been entered: 



LIST 

FILENAME *50* 1 6 0 ’ WITH 

I = 

"2 0" 

♦# 

30 

if ~ 

"40" = "50 = 

"60". 


The 

values which fail Detween 

the f 

i ie 

n a 

ni e 

and the first 

succeed i ng- 

oa ta 


definition item .will, be construed as constituting an slem-id test. Since 
there are no relational connectives associated with these item-id test 
elements* the process will explicitly retrieve items 50 and fc0. It will 

then test then to see ir trie dates definition item whose name is ! 1 ' will 
return tie value 20, 30* 4u» 50* or nu. In this case the item will 
succeed. Otherwise it will fail. Inis result nay ce unexpected. 


On the other hand* the form 


LIST *20' *30' 'A 0 * FILENAME *50' '60' WITH 1. 


will 

LIST 


behave line the following sentence: 

l- i Lc N a M t * Au ' * 30 * ' A0 ' '60' * 6u w I TH 1 


Further* the sentence 
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LIST "20""30""AO" FILENAME "50""60" 


will yield' the following error message: 

119] A VALUE WITHOUT AN ATTRIBUTE NAME IS ILLEGAL. 

> . 

The gist of this is that values delimited by ' will be taken as item-ias 
or i teci’i d test valuesi that values uelimitea by " or \ which fall between 
the file reference and the first data definition item will be taken as 
item-ids or item-id test values* and that all other values in the string 
delimited by " or \ will be associated with either the immediately 
preceding data definition item* if there is one* or with the next data 
definition item* or if there are no data definition items in the string* 
then the sentence will fail in the compiler. 
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1.5.5 On generating lists wnose elements are data. 


§ The historical intent of the SELECT and SSELECT verbs was to select a list 
of item-ids for retrieval of a specified collection of items in a 
specified order. There was an extension under k?7 which allowed selected 
parts of the contents of items to be returned instead. The intent was to 
be able to present lists of cata to BASIC or RUNOFF. There was a proDlem 
in the case which includea a sort pass, or in which a list was selected 
i mrred i ate I y pr i or to the data selection. which involved the list of item- 
ids being overwritten by the results of the data retrieval in some cases. 
This will no longer occur. It was always possible to execute the SELECT 
form of this operation from a saved list. 


1.5.6 Multi-line column-header labels in the columnar processor. 


It has been the case for some time that under certain circumstances the 
second and subsequent lines of the column-header labels would shift to the 
left or to the right. They will no longer do so. If you nave used 
column-headers which slid around, and if you fixed the problem py padding 
with blanks here and tnere. then tne following comments may be of 
interest. 



The proces-sor will take as the field width of a column the maximum of the 
longest line in tne column-header for that field or the length of the 
field specified in attribute 10 of the data definition item. This may 
make certain reports wjcer than they used to be. The processor used to 
take the maximum of the width of the lade I element specified for this line 
cr the fie la length specified in attribute 10. Trie problem occurred when 
a label element for a particular line was I o n y e r than the field specified 
in attribute 10. It occurred particularly in the case of file definition 
elements where the file name was longer tnanlhe field length definition 
in attribute lu. because on ' tne second anu subsequent lines the offset 
would snrink to the field length specification, causing all the rest of 
the label elements on trie second ana subsequent lines to shift to the 
left. If you have compensated for this by padding an element on the 
second line out to a lengtn sufficient to justify the co I urnn-header s. ycur 
report may become rton-c c I umnar • 


1.5.7 Totalling data elements of length zero. 

Data elements with a length of zero will now be totalled in trie columnar 
processor, although it will still take up one column in the output report. 



The use of zero length.elem-ents is at creak time. They will not print at 
detail time, out they will print at break time if desired. In that case, 
they are available to overlay data elements which printed at detail time, 
but wnicn are not intended tu p r i n t at break time. Arrangements of this 
nature are used in conjunction with function correlatives in both 
attributes 1 and 6 of the uata definition item to get numbers which are 
the result of operating on totals generated at detail time. There are 
facilities, for doing sone fairl> extensive, modifications to the output 
structure at break time. 
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1*5.8 Null su u-rnu I t i - va I ue s and the non-co I uinnar processor 


Historically* the non-columnar processor has terminated the display of 
sub-values within a value when it encountera the first null sub-value* 
iwhen it was processing.a sentence which dio not include the controlling 
and dependent specification. This had the effect of displaying a value as 
null if it was made up of a series of suo-vaiues* the first of which was 
null. The routine has been modified to scan past the sub-values which are 
null* and display the non-null sub-values* rather than immediately 
terminating the value on the first null. This may affect your non- 
columnar reports. The intent of this was to get the same numbers in the 
columnar and non-columnar reports. 


1.5.9 BREAK—ON and OET-SUPPhave been enabled for MODE ID3 verbs. 

A K0DEI03 verb is a verb which uses the non-columnar processor to generate 
a string which represents the results of executing the data definition 
items on an item* which then exits to special code to process the string 
into the required form. The LIST-LABEL and SORT-LABEL verbs use this 
path* tor instance. Note that this is one of the ways to extend.the power 
of the system. The user writes the code wnich is executed as MUDEID3* aria 
defines a verb which will exit to N0QEIQ3 with tne results of the non- 
columnar processor* rather than sending those results to a terminal or to 
a printer. 
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1.5.IQ The Load Previous Value ILPV) operator. 

In prior releases, if a data definition item included F-correI atives in 
^Lboth attributes 7 ana 8 and the results of the calculations done in 
^Pat tribute fa were desired in attribute 7. they had to be rep.l icated in 
attribute 7. In general* the function processor commences operation with 
no prior data. If attribute 8 commences with an F-correlative* there is 
no prior data set up by any processor in the system. Entering attribute 7 
there is the result of attribute fa* or at least the data retrieved from 
the item according to the specification in attriute 2 of the data 
definition item. It is now possible to Ioao this data into the function 
correlative stack using the LPV instruction. Noting that a conversion may 
call a function correlative* we may also load the last result of a series 
of conversions within a given attribute definition line into a function 
which follows the conversion in the line. For instance* 


DATA DEFINITION ITEM 
001 A 
002 3 


00? f jlpv;"ioo";/ 


008- F ; 2 ; 3 


data definition item mark 
specifies data attribute 3 


will divide the result of 
attribute 8 by 100. 
contents of data attribute 2 
times the contents of data 
attribute3. 


If this data definition item is totalled* the total generated will 
be loaded into attribute 7 and divided, by 100 prior to output on 
the o r e a k line. 

0025 Data attribute 5. 


too .> L j 


j /< r ;,o]F ; lp v ; "52"k ; "*c" ;: 3 T f IlE ;c; ;3 


fits nas rather less motivation* since it is equivalent to 


I'yJ ii f i 5 l U i J H K 4 8 J 


";r;"*c";:;( tfile; c;; 3). 


Use of tfie LPV operator in F-correlatives. 

In generai* tne i_r v snoulu be used as the first operator in an i- - 
correlative* because it nas"the" effect of loading the contents of the 
t esiDofar » uata area into the stack. if trie LPV is useu at other points in 
an F-correiative* strange things may happen. In some cases they might ue 

useful* out be aware that they are subject to change between releases. 

The LPV operator is available for use in A-correiatives. 

j'j.ii Length of the string returned by an F-cor relative. 

It has been possible to get a string back from an f-correiative which was 
up to 160 bytes long. This limit has been increased to 500 bytes due to 
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the increasing use of the F-correiative structure. If the string exceeds 
500 bytes* it will be truncated on the right. In general* if any single 
data string retrieved or generateo exceeds 500 bytes in ENGLISH* it will 
be truncated. A single data string is construed as the operation of one 
data definition item on one sub-value. 

^^5.12 T-* A- and F-co r r e I at i v e compilation. 

The ENGLISH compiler has been modified to allow more complete checking of 
. correlatives and conversions. All translates wilt be •'opened" during the 
compile abase* and marked in a more distinct way. 

Sequences' of conversion written in the form <C0NV1);(CGNV2>;... will be 
compiled to the form (CUNV1ICONV2 ]...)» which will run faster. Certain 
other minimal improvements of this nature have been made. 

A-correUt ives may now call A-cor r e I at i ves ana F-c or r e I at i ve s using the 
NIATTRNAME) form. The tree of A-c or r e I at i ve calls may be 7 levels deep. 


1.5.13 Inclusion of ‘(text)' in conversion called from an F—correI ative. 

The F-cor r e I a 1 1 ve will now execute a conversion which includes 
parentneses. This is useful for pattern-matching and for including 

parentheses in output masks. 

1.5.14 An extension to the translate. . 

The translate- syntax now allows the specification of value mark count in 
the iter which is the target of the translate* presuming that it is multi¬ 
valued. The form is as fellows: 

TF RENAME ; CM 1AMCJ GA,1C; BAM.' 

THE ' * * following the C is the VM.C of the value to be returned* if 
desired. if no VNC is specified* ana the target is multi-valued* then th'e 
string returned will include alt o'f the. values in tne attribute specified 
by GAMC or tsA i*. C delimited by blanks. Sub-values are always delimited uy 
blanks. 


1.5.15 dlanK line suppression. 

It is now possible to i_IST a file without any output by using the form 

LIST F I L c N A M b AT fk lBuTcNAhc * i Lf — SuFP PET —SUFP 

This nas the effect of printing trie page header and the column header 
without printing a line for eac:, item in the rile. If ATTRIbUTE namE was 
left dut of the statement* and there were no default attribute definition 
items picked up from the file dictionary* or the 'ONLY* connective was 
used* then the processor used to print a‘ blank line for each item in the 
file.- 

r ocessor has seen modified so that the form 
ID-SUPP DET-SuPP 
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LIST ONLY FILENAME 











tail! not print a blank line for each item in the file. 

If a blank line for each item in the file is desired* then the form 
LIST ONLY FILENAME IO-SUPP 


w i It 


suffice. 


The intent of this modification is to find those items which are in a list 
which are not in a given file. This is useful if you have two files which 
should have approximately the same item-ids in them* or if you have a 
saved list whichhas the desired record keys as its contents. In the 
first case one of the files must be selected* and in the second-case the 
list must oe retrieved. You snould then execute the following command: 


LIST ONLY FILENAME (CDI 


which has the effect of printing only 


17 80] ITEM "ITEMNAME" NOT UN FILE, 
for each item not on file, and 
NNN ITEMS LISTED. 


where ' N N \ * is the. number of items found in the file. 

If the option ' P' is included* the list will be sent to the printer. If 
the assignment is to a nolo file* then the resulting print file can be 
moved from a ho IU' file to a data file ana massaged with the EDITor to 
generate a vSiLuCTaDle item which may ue turned into a list of wnat is not. 
in'the' file. 


1.5.16 


i f t —<»u j u s true n t of page numbers in headings 


in place of the form 1 P' will cause the page number 
to be Ieft-ajjus tea in the required field* rather than right-adjusted in a 
field of four clanks. 


1 . 5.17 Measuring the length of a ■ a a t a string. 

It is possible to obtain tne length of a data string using the' ' L * 
conversion «ith an argument of f 0'. Simply execute the phrase LU in 
attribute 7 or 6 . 
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1.6 CHANGES TO RUNOFF. 

RUNOFF has been improved in ways which are mostly transparent. Some odds 
j and ends which improved symmetry or utility are noted below. There has 
■been a slight change to the handling of upper ana lower case commands* and 
the single-character overstrike and underline indicators. 


1.6.1 Upper- and lower-case controls. 

The modification of the upper-case* lower-case control structure causes 
the text to go to the case specified. The prior form caused the text to 
go to lower-case of lC was employed. The text then reverted to its 
natural state upon UC. This was useful when terminals tended to be upper¬ 
case only* ana the printer would execute lower-case. Terminals which 
handle lower-case are now prevalent* though there are still printers which 
ao not handle lower-case. UC was modified to switch the output to upper¬ 
case if UC was used. The new instruction* ENDCASE or EC has been 
implemented to turn off both the upper-case condition and the lower-case 
condition to allow tne text to go to its natural condition. 

The forms a a and \\ cause tne text to switch to upper-case or 
case in the same way that uC and LC cause the switch* except 

\\ nay be sxneeded in a line. Turning off the condition a* or 
the use of tL. > 

The.f.orffiS a, \, £, and a »iil produce one character of upper-case* lower¬ 
case* underline* or overstrike* as they were previously documented* but as 
they diu not previous! y■co; Each will be treated as the character itself 
if it is followed oy a blank. The backarro*. or underline character* _* 
continues to cause tne succeedino character to be taken as a text 


c h ar a 

Ctc 

r 

r 

cl t 

h c r 


t h a n a c 

r% 

w 

n t r o1 character* 

In i s ff*ean s that it 

you 

ha v e 

e x s 

s t 

i n 

- 

b 

n l; 

H i 

£ 

X t M t h t 0 

rnss such 

• as 'a v# 

1 • lb/ h f f tne coil 
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s i 
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v~, i i 

1 
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j V 
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rstruch 

ano the g 
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i 
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t h a 

t 

tne 


S 

e 
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t t'i C 
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i r 

•j 

c t 
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i 
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s t r ing 
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frequent t h a n t h eir 

u s e 
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T h e 

3 

i n g 

i £ 

- 

c.h 

a r a c 

ter tor s 


affect 

only the 

succeeding character 

• 

They 

o v e 

r r 

i :i e 

a 


n * v 

o r 

L 

C c o ;ii ■■ fs a r • u 

* 

or that 

character * and they have no e 

fleet 

on 


the UC ana Lu commana. 



to lowe r- 
that aa ana 
\\ requires 


The examsfe below is an attempt to display the interactions of the several 

cor’idtits jeon. The first part is the text which was sent to -RUNuPF and 
t. he s e c o n d p-a r t is the output from K t uFr . first* note t n a t the '* I 1 in 
'is* is always capital idea ty the s i r g I e-character a , and that the 'a' is 
a I ways j a • o « c r — c a s e cue t u trie s i ng t e—criaracter \ c or ;v<a n J . 


The first iine is In 

capitalized by the UC 

unif ormI y sent to low 

Sines contain a 'aa 

e x c e p r, i n : ' t h e ' a ' . a 

*o n I y w a y to re trie v e 

the use of EC command. 


its natural form. The second line is 'uniformly 
command* excepting the 'a'. The third line is 

er-case* except for the 'is'. The fourth and fifth 
text \\* string* which is uniformly capitalized* 

fter the \\ the string reverts tc lower-case. Tne 
the capitalization of the string * UC AND *Lu* is by 

Thus* the sixth line is in its natural form. 
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• LINE LENGTH Ub.PAkAGRAPH » J 

This Ais \a test of UC AND lC. 

. UC 

This ais \a test of UC AND LC. 

. I c 

This ais \a test of UC AND LC. 
This Ajs\a AAtest of UC AND LC. 
This ais Xa testW of UC AND LC. 
.ec 

This *is \a test of UC AND LC. 


This Is a test of UC AND LC. 
THIS IS a TEST OF UC AND LC. 
This Is a test of uc ano Ic. 
This Is a TEST OF UC AND LC. 
THIS IS a TEST of uc ana Ic. 
This Is a test of UC AND LC. 


. .Ex an pie of . u C a .iCi .EC and the associated a ana \ characters. 


6.2 The comment instruction. 

The .* command has been <adcea. This will inform the KuNOrF processor that 
ail of in e' rest of the text. in the line in which it occurs is a comment. 
It must either be at the beginning of the line* or after another command 
in a comr.and line. It is always the last command in a line. This allows 

text to st commented out* and the intent of READS and CHAINS to ae noted. 

« 

6*3 Treat m e n t at hyphens. 

Hyphens which are surrounded by alphabetic characters will allow a wore- 
Lr curt 'on the hyphen • j n rill and justify mooes # That is? if a term is a 
concatenation 'Ot ' t * o worcs separated by a hyphen? end the line overt lows 
within the second part ot the term? then the first part and the hyphen are 
left in the line? and the next line is commenced with the second part of 
t h e '*•» o f u « 

Similarly? if a i ine in me source text terminates wit h a hyphen preceeoed 
iy an a Io haba tic c na fact er? © n u the r if st character \n the next line is an 

alphabetic character? then!he last word in the line and the hypnen will 

be concatenated * i t h the first were in the next line arm output together 
in a line with the hyphen between the two parts# If there is a line 

o v e. r f \ o w » h i c h occ u r s cf n r i pc t h i s p recess? the h y p henated word will be 
handled as above* what the processor wi I I not, do is remove the hyphen* 

If the hyphen does not have this meaning? then the back-arrow character 
may be placed in front of it to suppress this action* 
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1.6.4 A change to HILITE 


The highlight command no longer causes a break in the text. This allows 
parts of paragraphs to oe nighiiyhted in justify or fill mode. 



The execution of the hilite command has also been modified so 
term .HILITE is the last character string in command line* 
equivalent to.HILITE OFF. 


that 

then 


i f the 
it is 


1.6.5 A note on SECTION spacing. 

Conventionally the .SECTION command is followed by a blank line before the 
next paragraph starts. Since the SECTION command causes a break which 
terminates the preceding paragraph* and since the text following the 
SECTION command is placed immediately into an ouput line and output prior 
to a consideration of the next line* the blank line after the SECTION 
command can be avoided by not indenting the first line of the next 
paragraph. That is* if tne processor does not know that the next line 
starts a paragraph* it will not skip; a line. It may oe necessary to use 
an INDENT MARGIN if paragraph indentation is desired* however. 


1.6.6 New options. 



The U opti-on has oeen aacea to force tne whole RUNOFF output to upper¬ 
case, if that is desired. The J option will suppress highlighting. . Tne C 
option will suppress the .CHAIM and .READ commands if it is desired to 
RUNOFF one element of a chained or treed structure. Tne I option wiil 
cause the name of the next item to be output by RUNOFF to be placed in -tne 
last line of tne last iter, kuNOF F • This of use with relative large 
documents. The 5 option, which suppresses underlining and overstriking 
remains. 


1.6.7 Other e rumen oat ions . 


You will note that the secuence <<< will tab over to the third tab if tabs 
are set* and tnut right tats are lore co-operative. Note the discussion 
in the spooler documentation unuer SR-lDIT on retrieving hold file entries 
for execution oy RUNOFF. 

The .READ or .CHAIN {FILENAME} ITEHMAHE commands allow any form of the 
file name and item name. Comments may succeed the .kEAu or .CHAIN command 
in the line if the item name is terminated with a trailing blank. 
Executable instructions in tne line after a .READ will not be executed. 
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1.7 CHANGES TO PRGC. 


7.1 The GO Command 

« 

In R8G* the PRGC branch command* G or GU* has been extended to allow for 
variable branching# Specifically* the user may use commands of the form 
GO A or GO An* where “A" and "An" reference specific parameters in the 
’primary input buffer. These commands will cause a branch to the label 
referred to by the contents of these buffer parameters. Note that if the 
label referencea does not exist* the PRGC will simply continue with the 
next statement following the branch instruction. An example follows: 


001 PQ 
002 R I 

003 3 ENTER MENU NUMBER ♦ 
004 SI 
005 IP: 

006 GQ A1 

007 X—INVALID RESPONSE! 


Example of f, GG An 1 * Command 
7.2 The Sec o n uary Input Buffer 

T h e s e c o n d ,i r y input buffer is now loaded with a a t a from several system 
processors* most notably the spooler. Information suer, as last no I d file 
e n try nu m t e r i s p i a c e a into t h is. buffer. More information on t n i s can u e 
found i n the spooler documentalS on in the PERIPHERALS, manual. The user 
s h o uid ■ n ste It a t trie- seco r, d ary i n put tuff e r is a IL L x t e m por.ary entity and 
tfia t if its contents are to be. usee* this stuuic be done immediately 
sutsegue it to the execution of the processor which loaded the buffer. 


Define PROC 

Clear input buffers 

Point to parameter position 
Get response from CRT 
Branch based on response 
Missing laoel number 









1*8 R80 BASIC IMPROVEMENTS 

There are many areas ot improvement to BasicThey can be generally 
u b r o k e n down into External differences* Speed improvements (both in the 
• compiler and in the run time package)* and new or modified Basic, syntaxes* 
Of tnese only the external differences can cause upgrade problems* 


1*8*1 BASIC program file structure. 


Gn the old systems* Basic source files had no structure, Source* object 
and symbol records were intermixed on the files. This cluttered up the 
files and made it difficult to manipulate only the source programs* 
Object code was frequently cataloged into the pointer file for the sake of 
run time efficiency* This caused problems because anyone could access 
programs in the unprotected pointer file. Also the object did not get 
saved/restored with the account on an account save/restore. 


Now there is a fixed structure for Basic source files. The file MUST have 
a dictionary and a separate data level. The Basic source programs are 
stored in the data level of the file. The compiler writes the object and 
the symbol file as one record into the dictionary. This makes it much 
simpler to manipulate the program source. It can be LISTed* T-QUMPed* T- 
L 0 A 0 e d * ana so on* without having to select the source items. The object 
record has the same format as a pointer-file record and so the dictionary 
"D" pointer .oust have a "DC* 1 in attribute one. The primary advantages of 
this .new format are: 

1* The object can now be protected with access/upcate locks. 

^2. The object saves/restores with, the account on account-saves. 

3. ThP'-pj A'T ALUG function is not necessary for run time efficiency. 


A • T h e r e 

is less uisk 

s i. a c e u t i 

1 i zed and fewer 

s t e ps to 

per form. 

5 • I h e m 
c o c e i r; t e 

a s i c u e ou g y e r 

grit y * 

can tell 

the name of the 

item and 

verify the object 


1.8.2 C A T 4 L u G e c O' A SIC p r og r a r s • 

Since the output 'of. ti»e compiler is the same as the result of the. verb 
CATALOG oncer k// and earlier releases* the CATALOG and DECATALOG verbs 

have changed meaning to some extent. Both are now TCL-II verbs. They 

r u u u I r e L h e o AS i C p r o * r a n. file name a no o n e or more explicit i tern- i u s * or 

a 1 * 1 * meaning ill? us usual* or that a list be in effect. It also means 

that you can catalog ail of the .basic programs in one file oy using the 
C A i u uuu v e f o' on I j once* a n u • similar I y v* i t h the utt A \ mLUG v e r d * 

The effect, of the'CATALOG vero is to point to the file which contains the 
pointer to the object code. The CATALOG verb no longer'neeas to go 

t h r o u g h t h e p seudc-loauing, process r ecu i r e a u n a e r k 77 and before. 



T n e ea n i n 

p u r p o s e j f 

is pointed 
file where 


i of the LGCATALOG vero has changec as well. It has the primary 
r e ;n o v i ng t h e object code string fro m t h e s y s t e m • Inis string 
to oy the pointer record in the dictionary of the BASIC program 
the prog rami resides. The program does not need to be cataloged 
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in order to use the OECATALUG vero. It Milt also remove the pointer left 
in the master dictionary by the CATALOG verb if there is one. The 
DECATALOG verb requires the name of the file in which the BASIC ’programs 
are stored. 



Note that with both of these verb the BASIC program file name and the 
program name are the only parameters used by the system. The basic 
program name is transferred to the object code pointer as its name* ana to 
the master dictionary pointer to the dictionary of the BASIC file. 
Similarly* the ooject pointer will reside in the dictionary of the file 
which contains the source program in the data section* and t he pointer 
which results from the CATALOG verb willpoint to that file* and the verb 
requires reference to the file. 


1.6.3 SPEED. IMPROVEMENTS 

Much wotk has gone into speeding up oasic. ubviously most of this kind of 
work is transparent to the user. The basic Compiler is now two to three 
times faster than on R77. This will improve programmer productivity. It 
may also help to reduce system development time. The compiler Is now 
doing more work than it used to. Optimizing logic has been added to 
improve run time performance especially in the areas of IF statements* 
literal array supscripts* anu concatenate functions. Other areas of the 
run time package that have notably improved are ail dynamic array 
functions*' locate function* case statement and format masks. 


I • h • 4 BASIC DEBUGGER 



On K77 tie use of the bAiiiu Leougger required the generation of a symbol 
table item. This had the name of the program preceded by an asterisKi eg. 
♦PGM. On RuG* the symbol table is embedded in the object code which is 
placed ii the catalog space.. The debugger* therefore* has instant access 
to the .symbol table* arm no longer requires me use of the * Z ' command 
except wien access to the source coue is required. In addition* a number 
of changes nave been mace to the overall debugger structure in oruer to 
correct a number of peculiar problems which arose with its use. Note that 
the user may still suppress generation of the symbol table cy using the 
(SI option when compiling programs. 


It should also be notec that a user now requires SYS2 privileges to use 
the Basic debugger. This prevents users from making unauthorized changes 
to data during reporting and data entry. Also* a new command nas been 
added which will display the current program name ana line number. 
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1.6.5 SYNTAX IMPROVEMENTS 


There are a number of minor syntax changes designed to reduce programmer 
effort and to increase the reachability of the basic program. 


* 


1.6.5.1 Cnange to the OPEN syntax. 

Note that the ONLY change to require a possible source code change is the 
OPEN change. 

OLD NEW 

OPE'i 'O' , • f i I ename ' OPEN • D I CT • , • f i I ema 


The word DICT must be explicitly supplied to open a dictionary level file. 
OPEN ",'filename* OPEN 'filename' 


The leading null expression is optional. Also the file name may be 
specified as 'DICT filename*. simplifying the inputing of filenames from 
the ter minaI. 


1.8.5.2 Tne DATA statement. 


DATA x 


u A F A x , x , x , . . . 


multiple - expressions 
ex pre ssian cecbmes 
process. 


are now a I 
the respor se 


owed on the- DATA statement. Each 
to one input request from the CHAINed 


1.8.5.3 Cnanges to EXTRACT e t alia. 


EXTRACTica,a m,v m,s v m) 

DELETE(da,am *vm,s vm ) 

INSE k T ( aa» am , v rn , s v m « n e w # 

R c P _ a C E l da . a m, v m , s v m, n e w ) 


EXTRACT Ida,an) 
DELETE(da,am) 

Iw5E k t (da,am;newi 
REPLACE iaa,aiT.ine,i! 


Trailing zero suovaiue or value mar-, counts are no longer required. no t e 
that in the I-NStRT a n c RE PLACt commands if they are err. i t tea the delimiter 
before tne new value must ue a semicolon. 


i.d.5.4 4 new EXTRACT syntax. 


EXTRACT( 


da,am»vm,svm) 


o a < a m, v m , s v m > 


This is a direct replacement, for the EXTRACT staterrent that should make 
the source code easier to read and understand. Note that trailing zero 
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1. 




sufcvaiue or value mark counts can 

8*5*5'.A new REPLACE syntax. 
y da*3EPLACE(da»am»vm*svm»new) 


be dropped. 


d a < a m» vm s svm>=new 


This is a direct replacement for the REPLACE statement. 

1.8.5.6 Tne IF ... ELSE form. 


IF 

x THEN 

NULL 

ELSE 

IF x ELSE 

IF 

NOT t x) 

THEN 


IF x ELSE ' 

The THEN 

clause 

of 

an 

IF statement is optional if the ELSE clause is 

pr esent. 

One or 

the 

o t h e r 

hOST.be present. 


1. 6 . 5 . 7 The L U C A T E( ) THEN form. 


LOCATE() ELSE LOCATE^) (THEN/ELSE) 

A THEN clause ft as been a a a e d to the LOCATE statement. The. LOCATE 
statement no- ocerates exactly line the new IF statement. 

1.6*6 ‘ N-t fi B. A S. 1 C • S Y N f A AES 


X • b • 6« i h R f as K' i n h i b i t t o n • 


BREAK GN 
u < l A K l.i r F 

These c o m ?. a n a s incre c* e- n t / cecre me nt tne oreaK 
they sr e c u rn n-u ! a* t i v e * If two BREA K (; f F s are 
be ex acute a to restore a breakable status. 

1 * c. 6 * 2 EC hL co ntr o i • 


ECHO Uh , 

l C r u OfF 

These commands turn the system echo-back on or oft. They may be used to 

subsress the .echo uack of. terminal input. 
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inhibit counter. Note that 
executed* two BREAK ONs mu s t 







1.8.6.3 format Nasks 


The format mask has been extended so that the user may specify a date 
format which is the same as any of the valid formats for the standard 
system *3* (date) conversion. 

^^8.6.4 Masked input. 

\ • 

INPUT £lx»y):yariable mask 


This is a- VEkY complex input function! It is capable of replacing as many 
as twenty lines of basic code used in screen input. Its functions include 
cursor addressing* output masking* editing* error messages* input masking* 
and exception trapping. 


This comnana itself is used for the actual entry of the data. Ancillary 
functions can be performed by the commands described below. In the above 
example* "variable" represents the name of the variable being input* and 
"mask" represents a standard EVOLUTION format mask. If the variable being 
used already has a value it will be displayed at the specified cursor 
address using "mask" as the output mask. Regardless* the cursor is 
positioned one character back of "x" in the "ai(x*y)" specification* the 
prompt cna-r acter is printed >ario input is requested. If the user presses 
the return Key* then whatever default value was there before will be 
accepted. Otherwise* the input will be verified against the mask* and* if 
acceptable* will be assigned to "variable". If the mask contains a 
decimal digit specification and/or a scaling factor* tnen numeric checking 



will 
R £ 10 ) 
o t h e r 


be performed. If the mask contains a length specification (eg. 
■tnen length checking will re serfortnea. If the mask is 'O' lor any 
valid date mask) then a date verification wiii be performed. 


Note t n a t data is converted ' on ou tp u t a r, n incut. Thus* if you wish to 
input a cate* the default should be stored in internal format* will be 
displayed anu input in output format ana will re placed back in the 
variable in internal tor mat. Note also that the ' 7.' is a numeric 
character verification symbol. 'Thus* for example* if the statement 
executed is INPUT 3(2u*10 >:SUC.SFC ' %/.%-%%->%%%*' and the data entered is 
423-15-6397 then SuC.StC will contain the vaiue 423156a97, If an error 
condition is encountered, then a message is printed at the bottom of the 
screen.' Soma simple examples follow; 


INPUT 

0(25,2) 

:INV.DATE ’O' 

Inputs a 

date. 

I NP ul 

(35,7) 

:AMOUNT ' K 2 * ' 

Inputs a 

dollar vaiue. 

INPUT 

i jj { Z W fl '1 

) • f i e ,"■ L ' L •• 6 L * 

inputs a 

t&xt rieia with 




a length 

specification. 

INPUT 

o 

* 

o 

■a 

: DE SC 

Inputs data with no mask. 
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8.6.5 Other INPUT forms. 

INPUTEKR expr 

INPUTTRAP *xx' GUTU n,n*n*n ... 
or 

INPUTTRAP 'xx' GUSUB n*n»n*n ... 
INPUTNULL x 


These are all support - functions.for the new form of input statement. They 
allow the user to tailor the INPUT function to conform to local standards. 

INPUTERR causes a message* specified by "expr"* to be printed on the last 
line of the screen. This differs from an explicit PkINT statement in that 
it sets a flag indicating that a message has been printed. Thus* when the 
next valid entry is made, the system will check the flag and clear the 
bottom line. 

INPUTTRAP allows the user to set a trap for a particular character or 
characters. Each character in the string specification corresponds to a 
label in the GOTO or GOSUE clause. Thus* for example* if the statement 
INPUTTRAP ! _X' GUTU 1C*ZU is executed* the subsequent entry of a 
character will cause a branch to 14 10" and the entry of 'X* will cause a 
branch to "20". The GUSUB form of this expression will cause a subroutine 
call to oe issue a instead. Caution - tne subroutine RETURN statement will 
cause a return to tne statement following tne INPUTTRAP statement - not 
the one following the INPUT statement. 

The I Np JINU Ll. statement allows the user to cefiri-e a character which is to 

signify th.it whatever default value was present is to oe replaced by the 

null string. Thus* if the statement INPUT’NUlL '/* is executed* the 

subsequent *- n 1 1 v of j * / * character will cause a defaulted value to go to 

null. Note that tne default character is dome examples follow: 


InPUTERiv ' I -N V A L I D u A T A 


displays error message 


INPUT TRAP •*/ 


G 0 T Li 11 J * I ( S 


Causes branching if e ; trier • * * 
or '/* is entered. 


INPUT NULL * a * 


Causes the * a> * character to null 

defaults in INPUT statements. 


exam p I e s of I N r U T k K K » i h P U f T A P ana I > < PUT N U L c 
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1.9 SYSTEM MANAGEMENT CHANGES 


C 


The process 
This section 
}the system, 
already noted 


of 

will 

To 


management of the system has not changed a great deal. 

note various changes which may affect the management of 
a great extent this will be a cross-reference to things 


1.9.1 The ’0* response during file restores. 

When a tape reaches the enu-of-tape mark without having finished the 
routine which it is executing* it will send the "mount next tape" message. 
When the next tape is mounted* the process will wait for the character 
* C *» at which time it will check the- tape laDel on the new tape for 
admissabiIity. If it does not like the tape label* it will say so* and 
wait for the tape to be changed to the correct tape* and the character 'C' 
to be entered. 

* 11 may occur that the tape that was mounted* which had a laoel that the 
processor did not like* was the correct tape, however. It is now possible 
td 1 execute the response 'u'* for override. This will cause the tape 
accept tne new reel without continuing to complain about the tabel. It 
may also cause the processor to complain about the label on the next tape? 
at which time the use of the *0' response is recommended. 


1.9.2. .Group format errors. 



Group, tor rat errors 
various processes 
reading or writing 


group format error 


have been discussed elsewhere in this 
which nay encounter group format err 
a fi1e «iiI enter a group format error 
condition is encountered. 


document. The 
or s d y either 
handler when a 


1 ■ 9 • 2 . L The >-1 i n i Lion or a group. 

The ter m group, is used to specify one 'bucket' of storage.* A tile is made 
up of i collection of groups, such that there are the same number of 
groups as tne number specified for tne moeulo of the file. Put another 
way, tne moouio of the rile specifies trie number of groups which make up 
the file. 

The hash i n u a I gor'i thm tat es the specified item-id ana decides in which 
group it is or should ue stored. The file retrieval or storage routine 
then searches that group for the specified item. Tne hashing algorithm 

nay be nought of as dividing the' item-io uy the moouio in order to obtain, 
•the r erria i nde'f . This remainder is then the 'group number'* and specifies 
the group wnicn is to ue searched. 

within each group the items are stored physical ly ena to end. Each item 

is made up of a count title* a Key* ar.o tne data. Tne documentation for 
this system has conventionally used the term 'item-id* inplace of the 

term 'Key*. It remains that the item-id is the key which is usee to look 
up the location of the item. 

^ Tne coup, t j i e ! a exists, only i n a file representation of the item. I t is a 

sixteen-bit binary number* such . that the high-order bit is zero* 
represented in the file in ASCII hexadecimal notation* ana as .such takes 
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up four bytes of storage. It immediately precedes the item-id in the 
file. If the item in question is the first item in the group* the count 
field starts in the first aata byte in the frame. If the item is not the 
first item in the group, then the count field starts at the first byte 
after the termination mark of the last item. 

PThe count field is usee as a pointer to the end of the item* The end of 
the item must be an attribute mark followed by a segment mark* If the 
count field does not point to this pattern? there is a group format error? 
and the group format error handler will be entered* 


1*9*3 Transient group format errors* 


The group format error may be transient or real* Transient group format 
errors will be encountered if another process is writing an item into the 
group at the same time that you ire trying to read an item in the group* 
The read without upaate routines? notably ENGLISH* RUNOFF* and PROC* will 
not cheCK the group locks which are set oy the upGate processor* In the 
case that the upaate processor is in the middle of an update* the various 
frames in the chain whicn makes up the group may not all be updated 
synchronously* There is* in other words* a stochastically-determined set 
of conditions under which a phantom group format error will occur* in 
which case the error handier will oe entered* It will normally not find a 
group format error* ana will exit back to the process it was executing 
when it s e*n sea tne group for a a t error* 


1*9*4 Real group format errors. 



A real g r oup 
an a 11'r i d u ie 

w r c n g * or it 


format error is sensed if 
mark* segment mark sequence 
tne data at the end of the i 


the count field does not point at 
. This may occur if the count is 

ten is wrong* 


The count tie la is definitely wrong if any or all of the four digits which 
make up the count field are not ASCII hexadecimal digits* which are X * 3 o 1 
- X 1 3 9 1 or X 1 A i* - X 1 6 * * which are 0-9 and A—F • 

The ena of item data may be wrong * if the count field contains the wrong 
ASCII hexadecimal digits* or it the enu of item data is actually wrong. 

The end of item data may be wrong in several ways* If the item is 
contained in a frame* then the ehc of item aata may be wrong in the ways 
that the tne count field may be wrong* If the item spans a frame 
boundary* certain other mechanisns come into play* If a process was in 
the process of updating an i ten.? to the extent that the first frame 
containing the item was written to disc* but that the last frame was not 
written when the process *a*s interrupted oy something like a cold start* 
then a group format error will occur. if the overflow handler becomes 
confused* the frame s a 11ac nea to a -group- may be acsuired by another data 
file o r o y a print file* f h e difference should be obvious on inspection? 
using the DUMP vero, Print files do not normally contain attribute or 
value marks ana data files u c not normally contain carra i ge-re tu r n* I me- 
feed sequences# - 


If the 

damaged 

frame 

i s the 

result of 

an incomplete update* then 

the 

a i f f i c j ! 

1 t y s 

i 'j> 

l ,7^ | 3 7- 

i w i j £ 

(JO, r fc 

C 3-i t 

o f this u 

r o up ## i 1 1 usually a 11e n u to 

the 

natter. 

I f 

t h e 

damage 

appear 

s to 

o e d u e l u 

CQ-owrier snip of the frame* 

the 

p r o b I em 

nay 

b e 

g reater 

. In 

this 

case it 

is best to leave the frame 

with 

the frame 

t 0 

wh i ch 

it has 

a 

fca c k- 1 ink 

* presuming that the data 

i s 
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consistent in that chain. Tnen cut the forward link in the spurious chain 
and terminate the group. 


The effect of the group format error handler is to terminate the group at 
the end of the last consistent item and cut the forward link out of the 
jlast acceptable frame in the group. The rest of the overflow is 
intentionally lost* Because of the effect of having two copies of the same 
frame referenced in the overflow chain. 


The one case in which the group will not be terminated is when a print 
file has meandered across the base of the file. In this case it is 
probably best to recreate the file and selectively restore it. The old 
file pointer should be thrown away. Do not use the DELETE-FILE verb on 
the old file* Decause this will further muddy the condition of the 
overflow handler. 


1.9.5 Recovery from group format errors. 

Since the overflow handler will chop off groups at the end of good data* 
the recovery strategy is to identify the file affected ano do a SEL- 
RESTGRE on tne file. It is best to do this as soon after the group format 
error is noticed as possible. 



In this context* note that the organization of file-save tapes written by 
R77 and later releases puts an enu-of-file mark at the end of each 
account* and a tape label at the beginning of each account. This means 
that the reel upon which the needed file starts may oe mounted* rather 
than starting at the beginning cf the tape. If the beginning of the 
required occurs in the middle of the desired accodnt* the an A opt ion. is 
to be used. 
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1.10 CHANGES TO THE ASSEMBLER 


Assembler Directives 


The Asset!bier has been changed to 
CHAIN directives. These can be 
assembling programs. 


suppress 
e-enabIed 


the execution of the EJECT and 
by using the (J) option when 


1*10.2 Assembler Files 

In R77 and prior releases* the u S Y M » P S Y M and TSYM files were one level 
(dictionary only) files. 

On R80* these files must have a dictionary. Note that the R80 sysgen 
procedure will take care of this for the standard system files* but users 
with their own versions should be certain to make the same change. 


1.10.3 Consents OptioTt • 

The Assembler on R8G no longer asks for comments when assembly is 
performed. 
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.11 R 80 ASSEMBLY DIFFERENCES 

I. Changes where made in the encoding of some of the instructions. This 
■means that AlL code must ce reassembled before it can oe run. 

^2. Branch conditions have been extended to cover all six* possible 
conditions. All branch instructions have Low* Low or Equal* Equal* Not 
Equal* High or Equal* ana high conditions (L*LE*E*NE*HE*H). For the 
single ooerand instructions these are Less than Zero* Less than or Equal 
to Zero* Zero* Not Zero* Higher trtan or Equal to Zero* and Higher than 
Zero (LZ,LfcZ»Z,NZ,HEZ*HZ). 

3. A branch decrementing by 1 instruction has been added. It has the 
same format as the single operand test £ branch but is a BDxx instead of 
bxx. For example* BONZ T 0 * L a b e I 

4. Monitor calls have been yiven unique names. This wilt avoid possible 
nasty results from mis-coding a monitor call and will help minimize source 
changes in the future. 

5. Register cetach functions should be done with the new commands LET* 
DETZ and uETO. These comma fids detach a register or detach it and zero 
(DETZ) or one (DETO) the aispI ace ment field. Manipulating the WA or DSP 
fields of a register directly is not valid and may cause may problems. 

6. To improve system security, setting t b'e tally USER to X * F b 12 1 no 

I oncja.r releases system access/up date locks. There is no way for a user 
account to bypass access/upaate Socks. Please be careful -- you can 
disable your system!! To prevent total disability* the account SYSPKOG is 

^considered privileged* and can access any system file regardless of 
Faeces s/uodate locks. 

7. The firmware will activate the user on every character keyed. This 

helps to -veep the user near the top of tne priority list ana prevents a 
considerable amount of a»sc thrashing. 

h • User coos cannot access Plb locations ether than tne' status bytes. 
Access to these two oytes must be through the monitor calls Plb. At. D/rld.uR 

9. The only approved way to open a file is o y using a new system function 

FlLEuPE;. T!: is replaces separate calls to the old functions G8MS ana 
GDLID, Tne OPEN processor has a simplified interface and will generally 
mean a reduction ‘in the coae required to open a tile. 

10. All string decrementing instructions were deleted because of a lack 

of firmware space. if you use a them you must recoce them in software. 

II. As mentioned in the R77 manual* the arithmetic condition flags no 
longer exist. * f > o u u s s o ip uo 1 i or uttal « as a r i t n hi etic flags after an 

accumulator operation* you must change the code to use explicit tests. 


PRELIMINARY 
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1.12 .SYSTEM DEBUGGER IMPROVEMENTS. 


A number of new 


^■^re most 
here is 
Everything 


I i k e I y 
only 
else 


features have been aflced to the System Debugger. These 
of interest only to the Assembly Language programmers, 
one change - the way the debugger is enabled,/disabled, 
is in the form of extensions or new commands. 


1.12.1 DEBUGGER ENABLE/DISABLE 

The procedure to enable/disable the system debugger has changed. On R77 
it involved physical front panel switches ana an IKI sequence. This was 
inconvenient* especially if a problem occurred when inexperienced 
personnel were operating the machine. The function of enable/disable is 
now done by typing L>6 when in the system debugger and on SYSPROG. Note - 
you must be on SYSPRuG to enable/aisable the debugger. The debugger will 
respond 36 ON if now enabled or OB OFF if now disabled. 


1.12.2 KI_ L ALL BREAK POINTS 

It is now possible to Rill all existing break points by typing K» 
carr iage-return. The debugger will respond with K-. 


1.12.3 KILL ALL TRACE VALUES 



It is now possible to Hill all existing trace values by typing U * 
carriage-return. Tne debugger will respond * i th U-. 


1.12. A liREAK. AT EVERY .STATEMENT IN A FRAME 


c y typing' b 
i n s t r u c t i o n 
e x e c e p t t n a t 
standard or 
return. 


.0 as a break point. the debugger will break at every 
in the frame *. This is equivalent to using an El function 
it only traces instructions within a given frame. This is a 
£k anu is Killed explicitly by typing Kx .0 or K c a r r i a g e 


1.12.5 V u R i a o L k V A u U n T k a C c 

A new function - trace by value - has been adueu t g the system debugger, 
when you type Yvariuoie the debugget will examine tne contents of the 
variable. Whenever the contents change * the debugger will break and print 

the a duress and tne. nt-w contents of the variable. This is extremely 
valuable «nen a var ianIe is being changed for unknown reasons or by an 
unknown processor. The process will run quite slowiy if a value trace is 
in effect necause tne system is or cawing after each instruction to test 
the contents of tne variable. Variable may beany direct* indirect* or 
symbolic variable that would oe vaiiu in a trace statement. You may value 
trace two variables at atime. 


To.kili value traces you either type Y carriage return or END to the 



-INARY CHANGES 


i. manual is prepared 
' FOR ATTRIBUTION. 

U 0 C U in t N T A T I 0 N 


for TEST PURPOSES 
16:AG:33 30 MAY 1980 

RELEASE 8U REVISION 


PAGE 






1.12.6 FRAME SUBSTITUTION 


A new function - frame suostitution - nas been adaed to the system 
debugger. When you type Fx*y to the system debugger* you initiate FRAME 


SUBSTITUTION. X ana y 
f Asubstitutiori is in effect* 
o the corresponding entry 


are frame numbers in decimal. When frame 
any external B5L or ENT to frame x will be made 
point in frame y. This allows one to test a 


new or moaifieu frame without disrupting the operations of the rest of the 


system. Presently you may only substitute one frame. 


To kill frame substitution you type either F carriage return or END to the 
debugger. 


1.12.7 ARITHMETIC FUNCTIONS 

As an add to debugging* all the system arithmetic functions have been made 
available when in the system debugger. Typing ADDO* ADDX* SU.BD* SUBX* 
MULD* MU _ X * l/IVD* u I V X * XTU* or U T X followed by the standard parameters 
will return the result to the CRT. 
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These are the steps to upgrade from R77 to R80: 


1. The C.E. Installs the new firmware board and performs any hardware 
tests necessary. 



8oot the system with the R80 SYSGEN tape. 

t 

Select the F option ana restore,the A8S section from the SYSGEN tape. 


4 . Change tapes to the first reel of your FILE-SAVE and restore the DATA 
section from your tape(s). 


5. When the restore is finished DO NOT do the COLDSTART proceedure! 
Instead* BREAK and type 'OFF'. 


6* Logon to SYSPRGG. 

7. Type 'ED MD T-EOU' and change line two (D) to '7G9A*. File the item.. 

8. Remount the R80 SYSGEN tape anti type 'T-EOD'. 


9. when the tape stops type 'T-F-WO'. 

10. Type 'T-LGAD HD < G I 1 * . 


11. Type 'SYSGEN-Rd0'. The SYSGEN True will begin executing. It will 
load system files RdG-UPDATE* SYS-ERkS* SYSPRUG-PL* BLOCK-CONVERT* NEwAC* 
ERRHSG, 3SYN, PSYN* STAT-FILE* PRUCLIb* ana ACC. It will then update the 
vert definitions in the. master dictionaries of all the accounts on the 

system. It then performs the CCLDSTaKT proceedure which will allow you.to 


set 


tne date 


ID. At this 
re-organize 


u I u l / D A f t i 


and time. 

p o in t * t he p ri m « r y updating is done. All that remains is 
the P01 H TtK-FlLt lists, to convert dASIC source files 
es * and re-compi le/catalog all your BASIC programs. 


to 

to 
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LOGON HAS BEEN IMPROVED TO REQUIRE ATTRIBUTE S OF THE SYSTEM 
TO CONTAIN THE LETTERS 'SYS*' BEFORE THE ENTRY WILL BE 
CONSIDERED VALID FOR LOGON. 'X,' MAY* BEL ANY AS<JI I CHARACTER. 

IF 'x' IS A 1, SYS1 PRIVILEGES WILL BE SET. IF ' x IS 2* 

SYS2 PRIVILEGES WILL BE SET. ALL OTHER VALUES OF 'x' WILL 
RESULT IN SYSO PRIVILEGES. 

ATTRIBUTE 11 MAY CONTAIN A LIST OF LINE NUMBERS FOR WHICH 
LOGON IS VALID. IF ATTRIBUTE 11 CONTAINS ANYTHING* IT 
IS ASSUMED THAT THE ENTRIES ARE VALID LINE NUMBERS FOR 
THE LOGON PROCESS TO VERIFY. WHEN THE LINE WHICH IS ATTEMPTING 
IS NOT SPECIFIED IN ATTRIBUTE 11* THE SYSTEM RESPONDS AS IF 
THE ACCOUNT DID NOT EXIST. 

THE VALID LINE NUMBERS MUST BE STORED IN ASCENDING ORDER. NUMBER 

RANGES ARE ALLOWED. EXAMPLE: 0,2-4,7*9*13-15 

THE ACCOUNT COULD ONLY LOGON TO THE FOLLOWING LINES: 

0 2 3 4 7 9 13 14 15 





